Merge pull request decentralized-identity#43 from dhh1128/master

add note about status of spec
swcurran · Oct 13, 2022 · 0918f3d · 0918f3d
2 parents 0f14981 + 3f91610
commit 0918f3d
Showing 1 changed file with 21 additions and 0 deletions.
diff --git a/index.html b/index.html
@@ -154,6 +154,27 @@
 <body>
 
 <section id='abstract'>
+    <p style="color:red">Editor's note, September 2022: This DID method works. There are reasonable, tested
+        libraries for it in
+        <a href="https://github.com/sicpa-dlab/peer-did-python">python</a> and
+        <a href="https://github.com/sicpa-dlab/peer-did-jvm">java</a>. It is convenient to use with
+        <a href="https://https://identity.foundation/didcomm-messaging/spec/">DIDComm v2</a>. It is in active use
+        within the Hyperledger Aries community, among other places, and has gravitas and momentum there. However, it is
+        not required when using DIDComm, and since peer DIDs were described, some methods with partly overlapping
+        functionality have become more popular. In addition, the method predates the formal DID standard
+        by almost two years; when the DID spec became a TR, it became desirable to update a couple details here
+        that were out of alignment. That work hasn't been done.
+    </p>
+    <p style="color:red">We are not formally deprecating the method. It represents an important milestone in
+        our explorations of what is possible with DIDs, and it still delivers value. However, we want people to be
+        aware that new work may be better focused on alternative methods. If you care about endpoints, sophisticated
+        delegation, multisig, and key rotation, we recommend getting the features of peer DIDs wth
+        <a href="https://weboftrust.github.io/ietf-did-keri/draft-pfeairheller-did-keri.html">did:keri</a>. If
+        you don't care about endpoints at all, and you don't plan to rotate keys, then
+        <a href="https://w3c-ccg.github.io/did-method-key/">did:key</a> may be a good choice.
+        Or you can continue to use this method. It's not going away; it just won't get a lot of attention going
+        forward.
+    </p>
     <p>This document defines a "peer" <a href="https://w3c-ccg.github.io/did-spec/#specific-did-method-schemes"
         target="didspec">DID Method</a> that conforms to the <a href="https://w3c-ccg.github.io/did-spec/"
         target="didspec">DID Spec</a>. The method can be used independent of any central source of truth, and is