Beveiligingsdocumenten noemen nog release 0.1.1 en een forge zonder runner #2716

New issue

Closed

opened 2026-11-02 22:16:48 +00:00 by brenno · 1 comment

brenno commented

2026-11-02 22:16:48 +00:00

Owner

Wat er mis is

Een lezer die wil weten welke versie fixes krijgt, of of de scans wel draaien, leest in de beveiligingsdocumenten feiten die sinds juli 2026 niet meer kloppen. De actuele release is v0.7.6. Er is een Forgejo-runner.

Bewijs

SECURITY.md Supported versions (rond regel 526): “latest 0.1.1, 2026-07-27”.
SECURITY.md Vendored bundle currency (rond regel 184–185): de CI-workflow “does not currently run — the remote is Forgejo with no runner”. De runner draait; scans.yml per pull request, time-degrading-checks.yml dagelijks.
docs/README.md regel 9: hetzelfde “latest 0.1.1”.
docs/SECURITY_DESIGN.md regel 8: “OciDeck has never tagged a release”. De zin erna gaat over de runner, niet over releases, en spreekt de eerste zin dus niet tegen. Releases bestaan sinds 0.1.0 (2026-07-25).
docs/API_DOCUMENTATION.md rond regel 773: dezelfde zin “has never tagged a release and has no versioning scheme”.
docs/SBOM.md rond regel 268: “the CI workflow, which is not currently running”.

docs/MIGRATION_GUIDE.md is op dit punt al gecorrigeerd (2026-07-28).

Voorstel

Gedateerd corrigeren, zonder een ondersteuningstermijn te verzinnen:

Supported versions versieloos maken en naar de releases-feed wijzen, of het genoemde versienummer laten toetsen tegen de nieuwste v*-tag (uitbreiding van test/docs_claims_match_code_test.dart), zodat 0.1.1 niet opnieuw blijft hangen.
De zinnen over “geen runner” en “CI draait niet” vervangen door wat er nu draait: statische poort en scans per pull request, de volledige poort op een v*-tag, make check blijft de poort van de indiener.
SECURITY_DESIGN.md en API_DOCUMENTATION.md: de “nooit een release”-zin schrappen en naar het bestaande versiebeleid wijzen. De opmerking dat de beschrijving de standaardtak volgt, kan blijven.

Het bestandsformaat verandert niet.

## Wat er mis is Een lezer die wil weten welke versie fixes krijgt, of of de scans wel draaien, leest in de beveiligingsdocumenten feiten die sinds juli 2026 niet meer kloppen. De actuele release is v0.7.6. Er is een Forgejo-runner. ## Bewijs - `SECURITY.md` *Supported versions* (rond regel 526): “latest `0.1.1`, 2026-07-27”. - `SECURITY.md` *Vendored bundle currency* (rond regel 184–185): de CI-workflow “does not currently run — the remote is Forgejo with no runner”. De runner draait; `scans.yml` per pull request, `time-degrading-checks.yml` dagelijks. - `docs/README.md` regel 9: hetzelfde “latest `0.1.1`”. - `docs/SECURITY_DESIGN.md` regel 8: “OciDeck has never tagged a release”. De zin erna gaat over de runner, niet over releases, en spreekt de eerste zin dus niet tegen. Releases bestaan sinds 0.1.0 (2026-07-25). - `docs/API_DOCUMENTATION.md` rond regel 773: dezelfde zin “has never tagged a release and has no versioning scheme”. - `docs/SBOM.md` rond regel 268: “the CI workflow, which is not currently running”. `docs/MIGRATION_GUIDE.md` is op dit punt al gecorrigeerd (2026-07-28). ## Voorstel Gedateerd corrigeren, zonder een ondersteuningstermijn te verzinnen: - *Supported versions* versieloos maken en naar de releases-feed wijzen, of het genoemde versienummer laten toetsen tegen de nieuwste `v*`-tag (uitbreiding van `test/docs_claims_match_code_test.dart`), zodat 0.1.1 niet opnieuw blijft hangen. - De zinnen over “geen runner” en “CI draait niet” vervangen door wat er nu draait: statische poort en scans per pull request, de volledige poort op een `v*`-tag, `make check` blijft de poort van de indiener. - `SECURITY_DESIGN.md` en `API_DOCUMENTATION.md`: de “nooit een release”-zin schrappen en naar het bestaande versiebeleid wijzen. De opmerking dat de beschrijving de standaardtak volgt, kan blijven. Het bestandsformaat verandert niet.

brenno added the

docs

label

2026-11-02 22:16:48 +00:00

brenno commented

2026-11-02 22:20:08 +00:00

Author

Owner

Aanvulling uit de documentatie-audit, dezelfde klasse, nog niet in de oorspronkelijke lijst:

docs/KNOWN_LIMITATIONS.md en docs/FAQ.md noemen 0.4.10 (2026-08-25) als laatste release.
docs/MIGRATION_GUIDE.md noemt nog 0.1.1 en opent met twee releases.
docs/CONTRIBUTING_GUIDELINES.md zegt dat er niets is uitgebracht, noemt 0.1.0+1 en “de app heeft geen versienummer”, en beweert in de app-lezer te zitten terwijl het bestand in repoOnlyDocs staat. In hetzelfde bestand staat wel dat v0.6.5 verscheept is.

De draaiende versie en de nieuwste bereikbare tag zijn 0.7.6. Zelfde voorstel: geen vast versienummer dat bij de volgende tag stil veroudert, wel een verwijzing naar de releases-feed. De migratiegids alleen compatibiliteit laten beweren die opnieuw tegen de code is gelezen.

Aanvulling uit de documentatie-audit, dezelfde klasse, nog niet in de oorspronkelijke lijst: - `docs/KNOWN_LIMITATIONS.md` en `docs/FAQ.md` noemen 0.4.10 (2026-08-25) als laatste release. - `docs/MIGRATION_GUIDE.md` noemt nog 0.1.1 en opent met twee releases. - `docs/CONTRIBUTING_GUIDELINES.md` zegt dat er niets is uitgebracht, noemt 0.1.0+1 en “de app heeft geen versienummer”, en beweert in de app-lezer te zitten terwijl het bestand in `repoOnlyDocs` staat. In hetzelfde bestand staat wel dat v0.6.5 verscheept is. De draaiende versie en de nieuwste bereikbare tag zijn 0.7.6. Zelfde voorstel: geen vast versienummer dat bij de volgende tag stil veroudert, wel een verwijzing naar de releases-feed. De migratiegids alleen compatibiliteit laten beweren die opnieuw tegen de code is gelezen.

brenno added the

in-progress

label

2026-11-02 23:11:13 +00:00

brenno referenced this issue

2026-11-03 00:46:15 +00:00

fix: dertien openstaande issues — documentatie, opslagraces, herstel en a11y #2762

brenno referenced this issue from a commit

2026-11-03 00:46:29 +00:00

docs: corrigeer verouderde release- en runner-beweringen (#2716)

brenno

2026-11-03 00:46:36 +00:00