Skip to content

docs: describe the DID documents the node creates, move DID background to the wiki - #4673

Open
reinkrul wants to merge 2 commits into
docs/rtd-scope-wikifrom
docs/rtd-move-did
Open

reinkrul wants to merge 2 commits into
docs/rtd-scope-wikifrom
docs/rtd-move-did

Conversation

@reinkrul

@reinkrul reinkrul commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

Part of the Read the Docs → wiki move (stacked on #4672).

docs/pages/technology/did.rst stays on RTD, rewritten to describe what the Nuts node does:

  • Subjects: creating a subject creates a DID Document for each method in didmethods; VDR V2 changes apply to all DID Documents of the subject.
  • DID Documents created by the node: a table for did:web and did:nuts with:
    • the DID format;
    • where the document is published;
    • which verification relationships get the signing key;
    • keyAgreement (never for did:web; for did:nuts unless keys.encryptionKey is false).
  • Azure Key Vault: set keys.encryptionKey to false, otherwise creating the subject fails.
  • Services: spec v2 uses Discovery, spec v1 uses did:nuts services. Links to the version incompatibilities page.

Moved to the wiki page Decentralized Identifiers:

  • the W3C quote and the background on DIDs;
  • how DIDs get meaning through credentials;
  • which DID method a use case uses.

Assisted by AI

The page is now on wiki.nuts.nl (Designing a Nuts Use Case), covering
both did:web and did:nuts.

Assisted by AI
@reinkrul reinkrul changed the title docs: move DID background page to the wiki docs: describe the DID documents the node creates, move DID background to the wiki Nov 6, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants