Skip to content

docs: clarify publishing Services for spec v1 and v2 use cases - #4681

Open
reinkrul wants to merge 3 commits into
docs/rtd-move-certificatesfrom
docs/rtd-move-services
Open

reinkrul wants to merge 3 commits into
docs/rtd-move-certificatesfrom
docs/rtd-move-services

Conversation

@reinkrul

@reinkrul reinkrul commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

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

integrating/version-incompatibilities.rst, "Publishing Services for use-cases", corrected after review:

  • spec v1 use cases publish endpoints as Services in did:nuts DID documents, managed with DIDMan
  • after upgrading to V6 these Services can be managed with the VDR V2 API instead (adds to all DIDs of the subject, no reference following)
  • warning: once you manage Services with VDR V2, you MUST NOT use DIDMan or VDR V1 anymore: VDR V2 keeps the subject's DID documents (e.g. did:web and did:nuts) in sync, DIDMan/VDR V1 only update did:nuts
  • spec v2 use cases list endpoints in the Discovery Service registration

The background (vendor DID with referenced endpoints) is on the wiki page Decentralized Identifiers, section "Services/Endpoints".

Assisted by AI

@reinkrul
reinkrul added this pull request to stack #4674 November 5, 2026 09:17
@reinkrul
reinkrul marked this pull request as ready for review November 5, 2026 09:30
@reinkrul
reinkrul force-pushed the docs/rtd-move-services branch 3 times, most recently from 8e4bde5 to e9f31b8 Compare November 6, 2026 11:29
@reinkrul reinkrul changed the title docs: move publishing services for use cases to the wiki docs: clarify publishing Services for spec v1 and v2 use cases Nov 6, 2026
@reinkrul
reinkrul force-pushed the docs/rtd-move-services branch 4 times, most recently from 0224b1c to 6428ac5 Compare November 6, 2026 13:07
@reinkrul
reinkrul force-pushed the docs/rtd-move-services branch from 6428ac5 to 9fee847 Compare November 6, 2026 15:57

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