The Standard for Public Code

How well Solid Memo meets the Standard for Public Code (version 0.8.1), what the maintainer decided, and what is left. Each criterion is a list of requirements, and each requirement is a MUST, a SHOULD or OPTIONAL. The project is committed to meeting the Standard, and says so with the commitment badge in its README; this page shows how far it has come.

This is an assessment of main at 2b780237 (version 2.1.1), made on 2026-10-16 (#78). Every requirement of the 16 criteria, MUST, SHOULD and OPTIONAL, was checked again against the Standard's own list. It replaces the re-review of 2026-10-13 (main at 90652c08 with the branch public-code-followup, updated in pieces until 2026-10-16 as changes landed), the assessment of 2026-10-11 (the branch standard-for-public-code, based on main at cae0a9f) and the first one, of main at 18eace6 on 2026-10-10. It is not a promise. Check items off as they land, and re-assess when they do.

Summary

The first assessment found strong engineering and weak process. The branch standard-for-public-code closed most of the process gaps with files and checks, and the maintainer has since changed every setting it asked for:

• Contribution guidelines, governance, a security policy, a code of conduct, a roadmap, issue forms and a pull request template.
• A policy page, a privacy page, a list of standards, objectives, a glossary, a user guide, and a README for every package.
• CI on every pull request, forks included, with one ci-ok check that main requires, and checks of the docs, the spelling, the formatting and the licenses.
• Discussions, private vulnerability reporting, secret scanning and push protection, all on.
• A changelog, publiccode.yml and CITATION.cff, and, with the branch semantic-release, versions released from the commits.
• Settings for running your own copy, and links from the app to its source code and its issue tracker.

The branch public-code-followup fixed what the re-review found: tests for the two scripts that had none, the standards missing from standards.md, the tool terms missing from the glossary, a checklist for reviewers, a plain statement that 0.1.0 was not tagged yet (which the branch semantic-release replaces, below), the maintainer's GitHub account in GOVERNANCE.md, CODEOWNERS and CODE_OF_CONDUCT.md, and this page.

The branch semantic-release replaces the plan to tag 0.1.0 by hand (decision 7): every commit follows Conventional Commits, checked by commitlint in CI, and semantic-release releases a version after CI passes on main. The first version is 1.0.0, and stable, and 0.1.0 is never tagged (releasing.md).

Since 2026-10-13, main has released eight versions, 1.0.0 to 2.1.1, each with a GitHub release, and the site runs only the newest. Every pull request goes through the merge queue, which merges it with a merge commit that names it. The release's key is in the release environment, which allows only main. CI fails a change to the public API that no commit calls breaking, and a commit that says no why or names no issue. CodeQL scans the code, and the five alerts it raised were fixed in pull requests (#96, #99 to #102). The project talks only in public and in writing (decision 13).

What is left falls into three groups:

1. Actions for the maintainer: making the project findable, and the leftover local branches.
2. Small fixes the re-assessment found, which this page records and does not make. Two of them would bring back SHOULDs met on 2026-10-13: terms that are not explained (10), and a DOI whose entry does not name the website (14).
3. Gaps that stay open for now. The largest is criterion 7, review by someone other than the author, which cannot be met honestly while the project has one maintainer, and is a decided gap until then. Criterion 6 is non-compliant: older commits on main record no reason and link no issue; both apply from 1.0.0 on, and CI now refuses a new commit without a reason or a link. Declaring 1.0.0 stable makes the 0.x dependencies it ships a partial in criterion 16, a decided gap (decision 14).

Scorecard

The counts are requirements met out of those in the criterion. Partial and unknown count as not met. A requirement that holds because there is nothing to apply it to counts as met, and the text says so.

A criterion is compliant when all its MUSTs are met. It is non-compliant when more than half of them are not met, and partial otherwise.

What changed since 2026-10-13

The re-review of 2026-10-13 scored 41/46 MUSTs and 36/51 SHOULDs. Two SHOULDs went from met to partial, and no MUST changed:

• Criterion 10, terms explained (SHOULD): met to partial. DOI came with the Zenodo archive on 2026-10-13 and is explained nowhere: the README shows it as a badge, and releasing.md and ROADMAP.md use it bare. The re-review also missed older terms that are neither explained before they are used nor linked to an explanation: ACR in data-model.md, WCAG in studio.md, and the EU data theme EDUC in deck-library.md, which names it but does not link the theme table.
• Criterion 14, a persistent identifier (SHOULD): met to partial. The Standard asks that the identifier's entry name the major contributors, the repository and the website. Zenodo's entry names the author and the repository but not solid-memo.com, although CITATION.cff gives it as url. The re-review counted the DOI alone.

Two verdicts changed within a count:

• Criterion 6, links to issues (MUST): not met to partial. Since 1.0.0, 65 of the 85 commits link an issue or a pull request, against none with a footer on 2026-10-13, and CI now refuses a commit that names neither. Partial still counts as not met, so the MUSTs do not change.
• Criterion 11, every standard listed (MUST): still met. The Arabic decks (1.1.0) brought text written right to left, which the app isolates by the Unicode Bidirectional Algorithm; the branch standards-list (#91) listed it in standards.md, with CSS Writing Modes and the other Unicode annexes the app relies on.

One OPTIONAL requirement was missing from the page and is added, met: courtesy translations (10). Everything else held. Where its text changed, it is to record what landed since: the releases, the merge queue, the release environment, the breaking-change gate, the commit checks, CodeQL, the changelog in the footer and the Arabic decks.

Earlier scores

main at 90652c08 alone scored 36/46 MUSTs and 31/51 SHOULDs. The branch public-code-followup added 4.3, 7.4, 10.3, 10.6, 11.3, 12.1, 16.2 and the changelog's SHOULD in criterion 16. The branch semantic-release turned 16.3 from met to partial: it declared 1.0.0 ready to use, and 1.0.0 ships four dependencies before their own 1.0.0. Its first release, 1.0.0, met 16.1 and the SHOULD to mark released versions in criterion 6, which brought the MUSTs to 41/46.

The assessment of 2026-10-11 scored 39/46 and 37/51, and the first one 17/44 and 8/50. Each later one was stricter than the last, and counts as partial what has not been done yet, such as reviews by someone else (7.2, 7.5), examples for every feature (9.6) and a check of the docs' coverage (12.7). The first assessment counted too few requirements in criteria 1, 10 and 11; the counts above are the Standard's own.

The five MUSTs left are in criterion 6, the commits on main that record no reason or link no issue, which the history keeps, though CI now refuses new ones; in criterion 7, a second reviewer, whose reviews would also cover the source, the policy, the tests and the docs; and in criterion 16, the dependencies before 1.0.0 that the stable app ships.

GitHub settings

Some requirements depend on settings that are not in the repository. This is their state on 2026-10-16. These were read from GitHub's and Zenodo's public APIs:

• Discussions and issues are on. The repository has a description, a homepage (solid-memo.com) and eight topics.
• The labels deck, interop and i18n, which the issue forms set, exist.
• The ruleset on main (24560297) is active. It blocks deletion and force pushes, and requires a pull request with no approvals, the ci-ok check, and the merge queue. The merge queue merges with merge commits and builds each pull request on top of main and those ahead of it, so the branch need not be up to date (testing.md).
• The ruleset "version tags" (25032384) is active, and protects refs/tags/v*: it restricts their creation, update and deletion, and blocks force pushes.
• The github-pages and release environments each allow deployments from main only.
• CodeQL's default setup scans the code.
• Every version from 1.0.0 to 2.1.1 has its tag and its GitHub release. Zenodo, connected to the repository, has archived each of them up to 2.1.0 under the concept DOI; its entry names the author and the repository's tag, but not the website.

The maintainer checked the ones that cannot be read without signing in:

• Private vulnerability reporting is on.
• Secret scanning and push protection are on.
• "Allow auto-merge" is on, so Renovate can add its pull requests to the merge queue, which merges them once ci-ok passes there too.
• The bypass list of the ruleset on main names "Deploy keys", for the release, which pushes each release commit through it. The bypass list of "version tags" names "Deploy keys" and the Repository admin role.
• The release's key is the environment secret SEMANTIC_RELEASE_KEY of the release environment, and is the only deploy key with write access; the repository secret of the same name, and the old deploy key, are deleted (#80). Every release since 2.0.0 ran from that environment.

Check them again before relying on them.

Criteria

What holds today, and what does not, criterion by criterion.

1. Code in the open

• MUST, met — the source code in use is public. Production runs only a released version, built from its release commit on main, the one its tag names, after CI passes on that commit (deployment.md), and only the newest version, once its GitHub release is made. A deploy by hand runs only from main, deploys the newest version, and runs npm run check on it first.
• MUST, met — the source of the policy in use is public. The SM-2 scheduler and the library's rules are in the repository (policy.md).
• MUST, met — no sensitive information about users or third parties, and no secrets in the tree or its history. The maintainer's own email address is in the 205 published deck versions, by his choice, and in the code of conduct, as its contact (privacy.md). The decks added since 2026-10-13, the four Arabic ones, give the issue tracker as their contact and no email address. Secret scanning and push protection are on.
• SHOULD, partial — publish code not in use. The history, the pull requests, the old deck and shape versions, each released version, tagged, and branches with work not yet merged are public. The 17 leftover pc/* and *-backup branches exist only on the maintainer's machine; they are most likely copies of work already merged.
• OPTIONAL, met — the footer on every screen links to the docs, the source code, the commit, the changelog, the issue tracker and Discussions (Footer.tsx, configuration.md).

2. Bundle policy and source code

• MUST, met — the policy is included. No public policy applies, and policy.md says so. It lists the outside rules the code follows (SM-2, the CLDR plural rules, BCP 47, NFC and DCAT-AP), with versions and links, and the project's own rules.
• MUST, met — no policy is based on source code, so there is none to include.
• SHOULD, met — policy in machine-readable formats. The project's own rules are SHACL shapes and the library's checks; SM-2 is pure functions in packages/domain.
• SHOULD, met — CI checks the code against the policy. sm2.test.ts reads the table of srs.md's worked examples from the page and checks the scheduler against every row, so a change to either that the other does not match fails; and npm run library:check refuses a new deck version without a license.

3. Make the codebase reusable and portable

• MUST, met — reusable in other contexts. A build reads its name, its repository, its Pod providers and its deck library from VITE_ settings (configuration.md), and reuse.md explains how to run your own instance. Since releases began, the deploy on GitHub Pages deploys only released versions, so a fork that uses it releases its own, with a deploy key of its own (releasing.md).
• MUST, met — no dependency on secret or proprietary software or services. The site is static, and every Solid server and identity provider it is tested with is open source. Their images are now pinned by exact version and digest, so every run tests the same servers. The release and the deploy run on GitHub Actions, for this deployment only; a build needs neither.
• SHOULD, not met — used by several parties.
• SHOULD, not met — a roadmap shaped by several parties. ROADMAP.md is public and says how to propose an item, but no other party has.
• SHOULD, not met — developed by several parties. Every commit on main is the maintainer's, Renovate's or the release's.
• SHOULD, met — configuration rather than code.
• SHOULD, met — localizable. The app speaks six languages, and card text in a language written right to left, such as the Arabic decks, keeps its own direction (i18n.md).
• SHOULD, partial — no situation-specific information. The app's name, its pod providers and its repository links are settings: the footer's links and index.html's links to the repository (its JSON-LD and its noscript source link) follow VITE_REPO_URL. What is still written for this deployment: index.html's absolute URLs on solid-memo.com (the canonical link, og:url, og:image, and the JSON-LD url, @id and image) and its description; the about page, with its address and its links to this repository; Solid Memo's wordmark and logo; CNAME, the domain the build writes sitemap.xml and robots.txt on; and the README. reuse.md lists them as files to edit by hand. The tree names no path on the maintainer's machine, but three old commits on main do, and the history keeps them.
• SHOULD, met — modules documented for reuse. Each package has a README that says what it exports and may import.
• SHOULD, met — no single-vendor platform. Any static host serves the site (deployment.md), and any Solid provider holds the data.

4. Welcome contributors

• MUST, met — anyone can suggest a change, in an issue, from one of the issue forms, or in a pull request from a fork, which CI runs on. Every pull request, the maintainer's and Renovate's included, is merged through the merge queue in the same way (#76).
• MUST, met — contribution guidelines in CONTRIBUTING.md.
• MUST, met — governance in GOVERNANCE.md. It, .github/CODEOWNERS and CODE_OF_CONDUCT.md now name the maintainer's own account, @ixuz; before, they named @antwika, an organization, which CODEOWNERS cannot use. A decision exists only once it is written in an issue, a discussion or a pull request, including the messages of its commits (decision 13).
• SHOULD, met — who pays for reviews. Volunteers, in their own time, with no funding (CONTRIBUTING.md).
• SHOULD, met — the engagement of organizations. GOVERNANCE.md says no organization is committed.
• SHOULD, met — a public roadmap in ROADMAP.md. Its "Done recently" stops at 1.0.0, and does not list what 1.0.1 to 2.1.1 brought.
• SHOULD, met — activity statistics. The README shows commit activity, the last commit and the contributors as badges, and links GitHub's pulse and activity graphs.
• OPTIONAL, met — a code of conduct: the Contributor Covenant 2.1, with a private email contact for reports.

5. Make contributing easy

• MUST, met — a public issue tracker, with forms for bugs, features, decks, translations and interop reports. Blank issues are off, so every issue starts from a form.
• MUST, met — the README links to the issues and the pull requests.
• MUST, met — communication channels. The README, CONTRIBUTING.md and the issue forms send questions to Discussions, which are on. The project talks only in public and in writing: issues, Discussions, pull requests and commit messages, with no chat and no calls, and only security and code of conduct reports are private (decision 13, GOVERNANCE.md).
• MUST, met — a closed channel for vulnerability reports. SECURITY.md points to GitHub's private vulnerability reporting, which is on. A reporter needs a GitHub account.
• MUST, met — instructions for reporting a vulnerability, in SECURITY.md.

6. Maintain version control

• MUST, met — every file is in Git.
• MUST, partial — decisions in commit messages. Of the 492 commits on main at 2b780237, 103 have no body once their trailers are left out, so they record no reason. 91 of them are from before 1.0.0 (d5d13c84), the same 91 as on 2026-10-13. Since 1.0.0, 12 of the 85 commits have none, and all 12 are merge commits: 11 made by the merge queue, whose message names the pull request whose description says why, and one merge of main into a branch (094e64be), which CI now refuses. Every other commit since 1.0.0 has a body: CONTRIBUTING.md asks for one that says why, Renovate's commits carry one (commitBody in renovate.json5): each update, from what version to what, where, its source and release notes, and why; and each release commit carries its changelog. From 1.0.0 on, every commit but the merge commits follows Conventional Commits, so its type records what kind of decision it was. Since 2026-10-15, CI's commits job checks with commitlint that every commit of a pull request has a body, and refuses a pull request with a merge commit, which commitlint skips. The history cannot change, so this stays partial; the maintainer decided that it applies from 1.x (decision 12).
• MUST, partial — commit messages link to issues and discussions. Of the 492 commits, 79 link an issue or a pull request; since 1.0.0, 65 of 85 do, and since the commit checks landed (#92), 24 of 25. Of the 20 since 1.0.0 that link nothing, nine are Renovate's, two are release commits whose changelog names no issue, seven are the Arabic decks and one the fix released as 1.0.1, rebased onto main before every pull request was merged with a merge commit, and one is the merge of main into a branch. CONTRIBUTING.md asks for a Closes: #NN footer, and CI's commits job checks with commitlint that every commit of a pull request names an issue, a pull request or a discussion by its number, and that the pull request closes its issue (npm run check:closes). Renovate's updates, which cannot name their pull request, carry the Why: line of their commitBody instead, and their merge commit names the pull request. The merge queue merges every pull request with a merge commit, which names it. Older commits on main link nothing, and the history cannot change; this too applies from 1.x (decision 12). It was not met on 2026-10-13, when no commit had such a footer.
• SHOULD, met — a distributed version control system: Git.
• SHOULD, met — guidelines ask for one logical change per commit.
• SHOULD, met — released versions marked. semantic-release tags each version vX.Y.Z and makes a GitHub release of it: v1.0.0 to v2.1.1, eight so far. The ruleset "version tags" restricts their creation, update and deletion (releasing.md).
• SHOULD, met — diff-friendly formats. CONTRIBUTING.md asks for text formats, and .gitattributes fixes the line endings.
• OPTIONAL, partial — signed commits and an email address. Every commit has an author's email address, but the maintainer's commits are not signed.

7. Require review of contributions

• MUST, not met — every contribution reviewed by someone other than its author. The maintainer merges his own pull requests without review, a temporary exception that GOVERNANCE.md states, and Renovate merges its own once CI passes, with no person reviewing them. Of the 37 pull requests merged since 90652c08, 26 are the maintainer's and none of them has a review; one, #96, is CodeQL's suggested fix, which the maintainer opened. The other 11 are Renovate's, and only #55 has an approval, from the maintainer. The release commit reaches main with no pull request: the release workflow pushes it from the release environment, which allows only main, and it holds only what semantic-release writes from commits already merged, reviewed or not, in their own pull requests. A decided gap while there is one maintainer (decision 12).
• MUST, partial — reviews cover the source, the policy, the tests and the docs. CONTRIBUTING.md and the pull request template say so, but no one other than the author has reviewed a change yet, so there is no review to check. A decided gap, as above.
• MUST, met — a written reason for every declined contribution. GOVERNANCE.md and CONTRIBUTING.md require one, and decision 13 keeps it public. No pull request has been closed without a merge since 2026-10-13, so the rule has had nothing new to apply to.
• SHOULD, met — review checks the standards, the architecture and the decisions. The template's checklist covers them for the author, CONTRIBUTING.md's review checklist for the reviewer, and npm run check:boundaries enforces the import rules. Since 2.0.0, CI also runs npm run check:breaking, which fails a change to the public API that no commit calls breaking, and the template asks whether a change breaks it.
• SHOULD, partial — review runs the software and the tests. CI runs every test that gates a change on every pull request, a fork's too, and again in the merge queue, on top of main (testing.md), and the reviewer's checklist says to try a change users see in the app, but there is no reviewer yet to do it.
• SHOULD, not met — a reviewer from a different context.
• SHOULD, not met — no unreviewed changes on main. The ruleset requires a pull request, ci-ok and the merge queue, but no approval, so the maintainer's own pull requests and the ones Renovate merges on its own reach main unreviewed.
• SHOULD, not met — review within two business days. It is a stated target, but one volunteer cannot assure it, and nothing measures it.
• OPTIONAL, not met — review by several reviewers.

8. Document codebase objectives

• MUST, met — objectives.md states the mission, the goals and who the app is for.
• SHOULD, met — objectives.md links each principle to the check that enforces it, and policy.md to the rules behind them.
• OPTIONAL, met — the about page explains the project to the public.

9. Document the code

• MUST, met — all functionality described, for learners in user-guide.md and for developers in the topic pages. The site serves these docs as pages at /docs/, which the about page, the site's page without script and publiccode.yml link to.
• MUST, met — how to install and run, in the README.
• MUST, met — examples of the key functionality: the user guide and the user journeys report.
• SHOULD, met — an overview for a wide audience: the README's "About" and the about page.
• SHOULD, met — how to run a standalone copy: the README's "Run it on its own", reuse.md, and guest mode as a test dataset that needs no Pod.
• SHOULD, partial — examples for all functionality. markdown.md, boundaries.md and deck-library.md have them, and courses, statistics and the Studio have journeys. But the user guide has no journey or worked example yet for guest mode, the theme, switching instances, or exporting and importing a deck file. Nor does it cover what came since 2026-10-13: it does not say that the library has Arabic decks, or that text written right to left runs right to left, and no journey edits a release's themes.
• SHOULD, met — the components and their relations, in architecture.md.
• SHOULD, met — CI checks the docs: markdownlint, cspell, lychee and the docs index (testing.md).

10. Use plain English

• MUST, met — the authoritative languages are documented: English only (the README, style.md).
• MUST, met — English is one of them.
• MUST, met — the docs are up to date in English, the one authoritative language. The releases, the merge queue, the release environment, the breaking-change gate, the commit checks and right-to-left text came with their docs (releasing.md, testing.md, i18n.md). This page was the one behind: it still listed the merge queue and the release environment as open after they were done. This update fixes that.
• MUST, met — the source code is in English.
• MUST, met — the bundled policy is in English.
• SHOULD, partial — terms explained. glossary.md covers the code's and the tools' terms, such as CI, SPDX, REUSE, npm, ports and adapters, and, since 2026-10-13, Conventional Commits, commitlint, semantic-release, SemVer, deploy keys and environments. The README and CONTRIBUTING.md link it. Other terms are explained where they are used, such as the merge queue (testing.md) and Zenodo (releasing.md). But some are neither explained nor linked. DOI is new since 2026-10-13 (the README, releasing.md, ROADMAP.md). Older ones the re-review of 2026-10-13 missed: ACR (data-model.md), WCAG (studio.md), and the EU data theme EDUC (deck-library.md), whose theme table is not linked.
• SHOULD, met — a plain reading level. Long pages open with a plain summary, and style.md asks for short sentences and everyday words. The technical pages are above that level, for their own readers.
• OPTIONAL, met — courtesy translations. The app's messages are in Swedish, Korean, German, Spanish and French too, and library decks carry their titles, descriptions and keywords in all six. The README says English is the authoritative language, and i18n.md says English is the source and how each translation was made. The docs are in English only.

11. Use open standards

• MUST, met — data is exchanged in open standards: the Solid Protocol, RDF, SHACL, DCAT, SKOS and the rest (standards.md).
• MUST, met — the status of each standard is recorded. standards.md marks the drafts and de facto specifications, and every specification used is open to read and to implement.
• MUST, met — every standard is listed with a link. The branch public-code-followup added vCard, the SPDX terms and license list, CSV, WCAG and the repository's own conventions, such as REUSE, publiccode.yml and Semantic Versioning. The Arabic decks (1.1.0) brought text written right to left, which the app isolates by the Unicode Bidirectional Algorithm (U+2068 and U+2069 in a message, and unicode-bidi: isolate in the style sheet); the branch standards-list (#91) listed it, with CSS Writing Modes, Unicode Text Segmentation and the Collation Algorithm, which the app already relied on.
• MUST, met — the drafts and de facto ones do not hinder reuse, and standards.md says why.
• SHOULD, met — where no standard existed, the project publishes its own open vocabulary and shapes in ns/. Since 2.0.0, api/frozen/ and npm run check:breaking keep a published shape or term from being taken back (releasing.md).
• SHOULD, met — machine-testable standards preferred: data is checked against SHACL shapes, by two engines in CI.
• SHOULD, met — no non-open standard is used, so there is none to prefer.

12. Use continuous integration

• MUST, met — all functionality has automated tests, at 100% coverage in every package. The scripts are covered too (npm run check:scripts), checkBreaking.ts and checkClosesIssue.ts, new since 2026-10-13, included, and shacl_crosscheck.py has its own tests, which CI runs before the cross-check (testing.md).
• MUST, met — contributions pass all tests before they are merged. CI runs on every pull request, in the merge queue and on every push to main, and ci-ok passes only when all its jobs did: build, library (the deck library and the public API compared with the change's base), crosscheck, pod, contract, journeys, docs and commits (commitlint and the closing keyword, on a pull request's commits). The ruleset requires ci-ok, on the pull request and again in the merge queue, on top of main and the pull requests ahead of it. Its bypass list names only "Deploy keys", for the release: semantic-release pushes the release commit with its key once CI has passed on main, and CI checks that commit too before it is deployed. The interop workflow's advisory servers report and do not gate, by design (testing.md). CodeQL also scans every pull request; it does not gate a merge.
• MUST, met — guidelines for structuring contributions in CONTRIBUTING.md and the pull request template.
• MUST, met — an active contributor who reviews contributions: the maintainer, with eight releases from 1.0.0 to 2.1.1 since 2026-10-13. One person is a thin margin, as criterion 7 shows.
• SHOULD, met — test results are public, for a fork's pull request too.
• SHOULD, met — one issue per pull request, as CONTRIBUTING.md and the pull request template ask, and npm run check:closes checks that a pull request closes its issue.
• SHOULD, partial — coverage monitored. Each package's test coverage is in the CI run's summary, and npm run check:docs keeps every page in the docs index. Nothing measures the docs' coverage: every package, app and end-to-end suite has a README today, but no check holds it, and nothing checks that every export has a comment.
• OPTIONAL, partial — the policy and the docs tested against the code. The generated vocabulary, the vendored packages' list, the SM-2 table and, since 2.0.0, the public API in api/ are checked: a test writes each of its files from the code and fails when they disagree (api/README.md). standards.md, the answers CSV's columns in statistics.md and testing.md's list of CI jobs are not.
• OPTIONAL, met — the docs tested for style and broken links: markdownlint, cspell and lychee.
• OPTIONAL, partial — the software tested with the docs' examples. sm2.test.ts checks the scheduler against srs.md's worked examples; the Turtle examples in the docs are not checked.

13. Publish with an open license

• MUST, met — the code and docs are under the MIT License. The decks carry their own open licenses.
• MUST, met — MIT is approved by the OSI.
• MUST, met — a license file, and every license's text in LICENSES/.
• MUST, met — no copyright transfer and no contributor license agreement (CONTRIBUTING.md).
• SHOULD, met — machine-readable notices in every file. The repository follows REUSE, and the docs job, which ci-ok needs, runs reuse lint (style.md); it passes at 2b780237, the public API's files in api/ included. npm run check:reuse checks that each deck is listed under the license it states.
• OPTIONAL, met — several licenses: MIT for the code and the docs, and each deck's own license.

14. Make the codebase findable

• SHOULD, not met — a descriptive name. The project is "Solid Memo", but the repository is still called website, by choice.
• SHOULD, met — a short description, on the repository, in package.json and in publiccode.yml.
• SHOULD, not met — submitted to software catalogs.
• SHOULD, met — a website that explains the problem for different readers: solid-memo.com/about.
• SHOULD, not met — findable by name in a search engine. Not checked, and the site is not registered with any search engine.
• SHOULD, not met — findable by the problem it solves. Not checked.
• SHOULD, partial — a persistent identifier whose entry names the major contributors, the repository and the website. Zenodo archives each GitHub release and gives it a DOI; the concept DOI, 10.5281/zenodo.23351087, is in CITATION.cff and the README. Its entry names the author and the repository, but not solid-memo.com: Zenodo does not take CITATION.cff's url. The re-review of 2026-10-13 counted the DOI alone.
• SHOULD, met — machine-readable metadata: publiccode.yml, checked in CI, whose documentation is the docs on the site, and CITATION.cff.
• OPTIONAL, met — a domain of its own, solid-memo.com.
• OPTIONAL, not met — regular talks at conferences.

15. Use a coherent style

• MUST, met — a style guide, style.md.
• SHOULD, met — style checked automatically: Biome, the Turtle formatter, markdownlint and cspell, in npm run check and CI.
• SHOULD, met — rules for comments and docs, in style.md.
• OPTIONAL, met — rules for understandable English, in style.md.

16. Document codebase maturity

• MUST, met — versioned. semantic-release releases a version after CI passes on main: eight so far, 1.0.0 to 2.1.1. The site runs only the newest released version, and the footer shows which. 2.0.0 was a major version by mistake: no commit in it breaks anything, but semantic-release read a line in a commit's body as a breaking change. releasing.md says so, and the release now counts only a BREAKING CHANGE: footer as written (#84, in 2.0.1).
• MUST, met — maturity stated. The README, the about page and publiccode.yml (developmentStatus: stable) say the app is stable from 1.0.0, its first version, and the releases page lists each version once it is released. No version before 1.0.0 was released, so the footer shows no version the docs disown.
• MUST, partial — a version ready to use depends only on versions ready to use. 1.0.0 is declared ready, and npm run check refuses a prerelease or 0.x dependency of the app, but four are allowed, each with its reason in vendor-code.md: rdf-validate-shacl 0.6 and rdf-validate-datatype 0.2, the SHACL engine the app uses, @inrupt/solid-client-errors 0.0, released with @inrupt/solid-client 4, and process 0.11, final at 0.11 by its maintainer's choice. A decided gap (decision 14). While the app was in beta, no version was declared ready, and this held.
• SHOULD, met — a summary of changes, in CHANGELOG.md: semantic-release writes each version's entry from the commits, and a section written by hand sums up what 1.0.0 contains. Since 2.1.0, the footer on every screen links to it.
• SHOULD, met — the version scheme, in releasing.md, with the public API a version promises and what counts as breaking for data in pods.
• OPTIONAL, met — Semantic Versioning, from 1.0.0. Since 2.0.0, CI fails a change to the public API that no commit calls breaking. 2.0.0 itself raised the major version with nothing broken, which Semantic Versioning allows.

Decisions made

The maintainer made these choices. Each is recorded where it applies.

1. Governance. One maintainer decides, in public, and gives reasons. A regular contributor can be invited as a co-maintainer. If the maintainer steps away, he hands the organization to a co-maintainer, or the repository is archived (GOVERNANCE.md).
2. Security contact. GitHub's private vulnerability reporting only: no email address and no /.well-known/security.txt (SECURITY.md).
3. Review. The maintainer merges his own pull requests without a second reviewer, as a stated, temporary exception (GOVERNANCE.md). The project invites a second reviewer.
4. Email in decks. The 205 published deck versions keep foaf:mbox, as a published version is never edited. A new version names the project's contact, a dcat:contactPoint that points at the issue tracker, with no email address. npm run library:check checks it for every version not published at the base (deck-library.md, privacy.md).
5. Repository name. Kept as website. The description and the metadata name the project.
6. License of docs/ and ns/. MIT, as for the code, stated in the README and set up with REUSE.
7. Maturity and versions (2026-10-13, replacing "beta, Semantic Versioning at 0.x, tagged by hand, with a changelog in the Keep a Changelog format"). Every commit follows Conventional Commits 1.0.0, Renovate's included, checked by commitlint in CI. semantic-release releases a version on every push to main that has a releasable commit, once CI has passed: it commits the version and the changelog back to main with a deploy key that the ruleset lets bypass its pull request, tags the commit and makes a GitHub release, from which Zenodo mints a DOI. The first version is 1.0.0, and stable; 0.1.0 is never tagged (releasing.md, CONTRIBUTING.md). Only a released version is deployed: deploy.yml deploys the commit a version tag names (deployment.md).
8. Renovate. Updates are merged automatically through pull requests (automergeType: 'pr'), once CI passes. Renovate cannot approve its own pull requests, so once main requires an approval, a maintainer approves each update and automerge merges it after that; Renovate gets no bypass. If that is too many approvals, automerge is narrowed, not the review (GOVERNANCE.md).
9. Formatting. Biome, with a line width of 100 (style.md).
10. Spelling. American English everywhere, checked by cspell.
11. Code of conduct. The Contributor Covenant 2.1. Reports go to the maintainer's email, which is published for that purpose.
12. Criteria 6 and 7 with one maintainer (2026-10-13). Decisions in commit messages (6.2) and links to issues (6.3) apply from 1.x: the commits before 1.0.0 stay as they are. Review by another contributor (7.1), and reviews that cover the source, the policy, the tests and the docs (7.2), are recorded as gaps while the project has one maintainer.
13. Open, written communication (2026-10-15). All collaboration, maintenance, decisions and discussion happen openly and in writing, in issues, Discussions, pull requests and their reviews, and commit messages, so every decision and its reasons can be found and linked later. The project runs and endorses no chat, direct messages, or voice or video calls or meetings. Something said elsewhere counts for nothing until it is written up in public, and a maintainer points such a message to the public channel. This binds the maintainers between themselves too. The two exceptions are private but still written: security vulnerabilities, in a private advisory made public once the fix is deployed, and code of conduct reports, by email or through GitHub's Report abuse (GOVERNANCE.md).
14. Dependencies before 1.0.0 (2026-10-15). Solid Memo is stable within an ecosystem that is not yet at 1.0: the Solid Protocol and Solid-OIDC are drafts, and the libraries around them are 0.x. The dependencies before 1.0.0 that vendor-code.md allows stay, each with its reason, and criterion 16's MUST on dependencies ready to use is a recorded gap until they reach 1.0.0 or a ready replacement exists. A new dependency before 1.0.0 is still refused unless it is added there with its reason.

Whatever is decided later:

• Deck attribution stays "Compiled by Anton Wiklund with the help of AI". No contribution or review text may say or imply that the maintainer reviews decks.
• Published decks/*/vN.ttl, ns/shapes/*/vN.ttl and ns/vocab/vN.ttl files are never edited. A change ships as a new version.

What remains

Each item below starts with its state: Done. when it has landed, Open. when it has not.

GitHub settings (admin)

Only an admin of the repository can change these. All are done:

• Done. Private vulnerability reporting. On, and its exclusion is gone from lychee.toml. (5)
• Done. Secret scanning and push protection. Both on. (1)
• Done. Discussions. On, and their exclusion is gone from lychee.toml. (5)
• Done. Topics and description. The description and homepage are kept, and topics are added. (14)
• Done. Labels. deck, interop and i18n exist, for the deck, interop and translation forms.
• Done. The ruleset on main (24560297). It requires ci-ok, and its bypass list is empty, so Renovate has no bypass. (7, 12)
• Done. Allow auto-merge. On, so Renovate can add its pull requests to the merge queue once ci-ok passes.
• Done. The merge queue on main. The ruleset on main requires the merge queue, merging with merge commits, and no longer requires branches to be up to date (#76). (7, 12)
• Done. The github-pages environment. main is its only deployment branch. The deploy runs from main even when it deploys a version's tag, so this still holds. (1, 12)

Actions for the maintainer

• Done. The blame-ignore list. The branch standard-for-public-code was merged with a merge commit (pull request #37), so the reformat's SHA in .git-blame-ignore-revs (7646413, "Reformat the code with Biome") names a commit on main (style.md). (15)
• Done. Zenodo. Connected to the repository, so each GitHub release gets a DOI. (14)
• Done. The release's deploy key, before the branch semantic-release is merged. Make an SSH key pair, add its public key as a deploy key with write access, its private key as the repository secret SEMANTIC_RELEASE_KEY (to be moved into the release environment, below), and "Deploy keys" to the bypass list of the ruleset on main, as releasing.md says. (1, 6, 16)
• Done. The first release. The merge of the branch semantic-release released 1.0.0: the release commit and v1.0.0 are on main. (1, 6, 16)
• Done. A ruleset for version tags, on refs/tags/v*, that restricts their creation, update and deletion, with "Deploy keys" and the Repository admin role on its bypass list, as releasing.md says. The deploy deploys the commit a version tag names, so without it anyone with write access could pick what is deployed. (1)
• Done. The release environment (#80). Make it, or open it if a run has made it already, with main as its only deployment branch, move the key into it as the environment secret SEMANTIC_RELEASE_KEY, and delete the repository secret, as releasing.md says: a repository secret can be read by a workflow on any branch. Keep the release key the only deploy key with write access, as both rulesets' bypass lets every such key past. (1)
• Done. The DOI. Add it to CITATION.cff and the README, in a pull request. (14)
• Done. Software Heritage. A copy of the repository is preserved there, first as snapshot swh:1:snp:dcf5c64c3cf402c99c0cf9ab72ebe36ba158d74b (3.2.0), and Software Heritage visits it again for new commits. The repository stays where it is, and maintained; the copy only keeps the code findable if GitHub ever is not. (14)
• Open. Search engines. Verify solid-memo.com in Google Search Console and Bing Webmaster Tools, and submit sitemap.xml. (14)
• Open. The Solid community. Ask for a listing on solidproject.org, and post about the project on the Solid forum. (3, 14)
• Open. Local branches. Delete the 17 leftover pc/* and *-backup branches on the maintainer's machine, or publish any that holds work not on main. (1)
• Open. A second reviewer. Then require one approval and code-owner review on main. Renovate's pull requests then wait for a maintainer's approval too, and automerge merges them once it is given (decision 8). (7, 12)

Small fixes the re-assessment found

Found on 2026-10-16 and not made here, as #78 leaves fixing to later changes:

• Open. Terms. Explain DOI, ACR and WCAG in glossary.md, or where they are first used, and link the EU data theme table where deck-library.md names EDUC. (10)
• Open. The DOI's entry. Make Zenodo's entry name solid-memo.com, for example with a .zenodo.json that lists the website as a related identifier, since Zenodo does not take CITATION.cff's url. (14)
• Open. CodeQL in the docs. CodeQL scans the code, but no page says so: testing.md and SECURITY.md could say what it checks and that its alerts are fixed in pull requests like any other change. (12)
• Open. ROADMAP.md. "Done recently" stops at 1.0.0; add what 1.0.1 to 2.1.1 brought, such as the merge queue, the breaking-change gate and the Arabic decks. (4)
• Open. The user guide. Say that the library has Arabic decks and that text written right to left keeps its direction, alongside the examples criterion 9 already lacks. (9)

Gaps that remain

These are not met, and the settings and actions above do not close them:

• Criterion 7, review by another person. A decided gap (decision 12). With one maintainer, his own changes have no second reviewer, and Renovate's updates are merged with no reviewer at all. A second reviewer, with one approval required on main for every pull request, Renovate's included, closes the MUST on review, and the SHOULD on no unreviewed changes. Their reviews would also show that reviews cover the source, the policy, the tests and the docs, and run the app. The SHOULD on a reviewer from a different context needs that reviewer to come from one, and review within two business days needs enough reviewers to assure it, and a way to measure it.
• Criterion 3, several parties. Use, the roadmap and development by several parties need other parties. The roadmap invites them, but none has joined.
• Criterion 3, situation-specific information. index.html's site URLs, CNAME (which the build writes the sitemap and robots.txt from) and the about page name solid-memo.com, and the about page links to this repository. A deployed site needs them, and reuse.md lists them for a copy to change. Three old commits name paths on the maintainer's machine, and the history keeps them.
• Criterion 6, decisions in commit messages. 91 of the 407 commits on main before 1.0.0 record no reason, and rewriting main to add them is not an option. The requirement applies from 1.x (decision 12): CI refuses a new commit with no body, so the share without a reason only shrinks.
• Criterion 6, links to issues. 20 commits since 1.0.0, and most older ones, link no issue, and the history keeps them. It applies from 1.x (decision 12): CI refuses a new commit that names no issue, pull request or discussion, and every merge commit names its pull request.
• Criterion 9, examples for all functionality. Guest mode, the theme, switching instances and deck files need a journey or a worked example in the user guide, and so do the Arabic decks and a release's themes.
• Criterion 12, the docs' coverage. Nothing checks that every package has a README, or that every export has a comment.
• Criterion 16, dependencies ready to use. A decided gap (decision 14). The stable app ships four dependencies before their own 1.0.0 (vendor-code.md). Each reaching 1.0.0, or a replacement ready to use, would close it. process is final at 0.11 by its maintainer's choice. shacl-engine 1.x exists, but brings in packages before 1.0.0 of its own and a SPARQL engine the app does not need.
• Criterion 14, findability. The repository name is kept by choice. Catalogs and search engines wait for the actions above. The DOI is in CITATION.cff and the README; its entry waits for the small fix above.

The plan, as it landed

The first assessment's plan, each item marked Done. when it has landed and Open. when it has not: most of it landed on the branch standard-for-public-code.

Phase 1: files and small fixes

• Done. Footer. The repository URL comes from VITE_REPO_URL. Every screen links to the source code, the commit, the issue tracker and the version, in every language the app speaks (Footer.tsx).
• Done. CONTRIBUTING.md, linked from the README.
• Done. GOVERNANCE.md and .github/CODEOWNERS.
• Done. SECURITY.md. No security.txt, as decided.
• Done. Templates. Issue forms for bugs, features, decks, translations and interop reports, config.yml (which points conduct reports to their email contact), the pull request template, and CODE_OF_CONDUCT.md.
• Done. README. About, Status, Run it on its own, Contributing, the language statement, the badges, the journeys report and the licenses.
• Done. New pages: objectives.md, policy.md, standards.md, privacy.md and glossary.md, the full SM-2 citation, and links to the specifications.
• Done. ROADMAP.md.
• Done. Metadata and style. publiccode.yml, CITATION.cff, CHANGELOG.md, releasing.md, .gitattributes, .editorconfig, style.md, the root package.json's metadata, and the JSON-LD in apps/web/index.html.
• Done. Package docs. A README and a description for each package, e2e/journeys in architecture.md, and the maturity of the 0.x dependencies in vendor-code.md.
• Open. Branches. The leftover pc/* and *-backup branches remain on the maintainer's machine (above).

Phase 2: CI and GitHub settings

• Done. ci.yml. Runs on every pull request and on pushes to main, with the ci-ok job, a read-only token and no secrets.
• Done. The deck library's base. Compared in ci.yml's library job, which ci-ok waits for; ns.yml, whose checks were all in ci.yml but that one, is gone.
• Done. deploy.yml. It deploys only a released version: after CI passes on a commit a version tag names, or, run by hand, only from main, the newest version, after npm run check. Either way, only the newest version, from its release commit, once its GitHub release is made.
• Done. renovate.json5. automergeType: 'pr', and a commitBody that records each update and why.
• Done. Checks in npm run check. The docs index (npm run check:docs), prerelease dependencies (npm run check:dependencies), and each package's coverage in the run's summary.
• Done. A docs job. lychee (offline on every change, online weekly), reuse lint and the publiccode.yml parser; markdownlint and cspell run in npm run check, so in the build job.
• Done. License required. npm run library:check refuses a new deck version without dcterms:license, and sm2.test.ts checks the scheduler against the table it reads from srs.md.
• Done. GitHub settings. Listed above, all done.

Phase 3: larger work

• Done. Configuration. VITE_APP_NAME, VITE_REPO_URL and VITE_POD_PROVIDERS, configuration.md, reuse.md, and a generic custom domain section in deployment.md. No CI build under a subpath.
• Done. User documentation. user-guide.md, statistics.md, browsing.md, examples in markdown.md and boundaries.md, and a plain summary at the top of long pages.
• Done. Formatter and linter. Biome in npm run check, with the reformat in .git-blame-ignore-revs.
• Done. REUSE. REUSE.toml, LICENSES/, SPDX headers, the license on the ns/ graphs (vocab.md), reuse lint in CI, and npm run check:reuse for the decks' licenses.
• Open. Releases. The version shows in the footer, semantic-release releases each version from the commits, and only released versions are deployed, from tags a ruleset protects. The archive remains (above).
• Open. Findability. The about page is done and in the sitemap, which the build writes. Search engines and the Solid community remain (above).
• Done. Deck contact. New deck versions name the project's contact.
• Open. A second reviewer.

Checking progress

• The full check passes at 100% coverage after every code change. Run npm run crosscheck, npm run format:turtle and npm run library when ns/ or decks/ change.
• GitHub's community profile (/community) shows every item.
• A pull request from a fork runs CI, ci-ok is required, and the template appears.
• A pull request that edits a published deck version fails.
• A deploy by hand from a branch other than main is skipped.
• A push to main that releases nothing is not deployed; a release commit is, once CI passes on it, and a deploy by hand deploys the newest version.
• The footer's links open the source code, the commit and the issues on solid-memo/website.
• GitHub's blame of a reformatted file on main shows the change that wrote each line, not the reformat.
• lychee.toml excludes no address whose setting or tag now exists.
• Go through the criteria again, and update the scorecard here, with the commit of main assessed and the date. Count the commits as this page does: a body is what is left once the trailers are left out, and a link is an issue or pull request number or address.