flesh out why/what, link back from spec to repo

README.md

@@ -31,7 +31,7 @@
 Thoughts:
 - The App Frontend should be separated from the App Backend
 - It should be clearly labelled that the clear names don't pass through the
-  app.
+  app backend.
 
 -->
 
@@ -74,12 +74,29 @@ students without putting their data at risk.
 
 [GDPR]: https://eur-lex.europa.eu/eli/reg/2016/679/oj
 
+#### _Draft 3_
+
+As app creators we have a special duty to protect the personal data of
+children. The simplest way to do that is to not receive it.
+
+We want to have a simple and common way for teachers to recognise their
+students without putting their data at risk.
+
 ### What
 
 This is a specification and implementation guide for interoperability of
 educational apps and user identity systems such that apps can show user
 names without revealing those names to the creator of the app.
 
+We name it client-side depseudonymisation or simply d16n.
+
+D16N refers to the Depseudonymisation process used in integrations, where
+pseudonyms (abstract IDs) are exchanged instead of clear user names. This
+functionality allows a user's browser to communicate directly with IDP
+servers to resolve these IDs into identifiable names. D16N enhances privacy by
+ensuring that user identities remain protected during data exchanges,
+particularly in educational contexts where sensitive information is involved.
+
 ### For Whom
 
 - You are an Identity Provider who works in the education system.
@@ -111,14 +128,14 @@ already.
 
 ### Identity Providers
 
-Project Name        | Maintainers       | Point of Contact      | Project URL
+Product Name        | Maintainers       | Point of Contact      | URL
 ------------------- | ----------------- | --------------------- | -----------
 
 
 ### Applications
 
-Project Name    | Maintainers      | Point of Contact           | Project URL
---------------- | ---------------- | -------------------------- | ----------------------------
+Product Name    | Maintainers      | Point of Contact           | URL
+--------------- | ---------------- | -------------------------- | --------------------------
 bettermarks     | bettermarks GmbH | [email protected]    | https://bettermarks.com/
 
 

spec/d16n-v1_0.adoc

@@ -7,9 +7,7 @@ bettermarks GmbH
 v1.0, 2024-11-15
 :toc: right
 
-
-// TODO: Include links back to this repo, for the case that reader is viewing
-// github pages.
+The source for this specification can be found at https://github.com/bettermarks/d16n.
 
 [abstract]
 .Abstract