From abad998749509525cf4adf67a381e6a6e8662816 Mon Sep 17 00:00:00 2001
From: Mikael Frykholm <mifr@sunet.se>
Date: Fri, 18 Aug 2023 09:33:20 +0200
Subject: Add documentation.

---
 docs/Publish.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/Publish.md

diff --git a/docs/Publish.md b/docs/Publish.md
new file mode 100644
index 00000000..6d302d4a
--- /dev/null
+++ b/docs/Publish.md
@@ -0,0 +1,50 @@
+### Metadata publish workflow
+The basic workflow is to:
+1. Check metadata in metadata web tool: https://metadata.swamid.se/?showEntity=1234
+2. check out swamid-metadata repo
+3. cd swamid-metadata/metadata
+4. Install dependencies:
+`apt install xsltproc libdate-calc-perl libxml2-utils xmlsec1`
+
+5. `scripts/get-metadata.sh 1234`  *Where 1234 is the entity number from website above*
+
+.
+
+    Replace login.sunet.se-oidc-authenticate-broker.xml with metadata [Y/n]? y
+    ~/s/s/metadata (master)> git diff *Should show expected diff*
+6. `make tag`
+
+.
+
+    cd ..; make tag
+    make[1]: Entering directory '/home/mikael/src/swamid-metadata'
+    cd metadata ; make commit
+    make[2]: Entering directory '/home/mikael/src/swamid-metadata/metadata'
+    Recreating MXML files
+    swamid-2.0.mxml validates
+    swamid-discovery.mxml validates
+    swamid-edugain-1.0.mxml validates
+    swamid-edugain-idp-1.0.mxml validates
+    swamid-edugain-sp-1.0.mxml validates
+    swamid-idp-2.0.mxml validates
+    swamid-idp-transitive.mxml validates
+    swamid-idp.mxml validates
+    swamid-interfederations-2.0.mxml validates
+    swamid-registered.mxml validates
+    swamid-sp-2.0.mxml validates
+    swamid-sp-transitive.mxml validates
+    swamid-testing-1.0.mxml validates
+    swamid-testing-idp-1.0.mxml validates
+    swamid-testing-sp-1.0.mxml validates
+    <snip>
+    Differences between tag md-2023-08-17-v02 and what you are about to sign:
+    diff --git a/metadata/swamid-edugain/login.sunet.se-oidc-authenticate-broker.xml b/metadata/swamid-edugain/login.sunet.se-oidc-authenticate-broker.xml
+    index 7f41b2b5..2fb2eed2 100644
+    --- a/metadata/swamid-edugain/login.sunet.se-oidc-authenticate-broker.xml
+    +++ b/metadata/swamid-edugain/login.sunet.se-oidc-authenticate-broker.xml
+    @@ -46,6 +46,7 @@
+    <snip>
+    ONLY SIGN IF YOU APPROVE OF VERIFICATION AND DIFF ABOVE
+
+7. Touch yubikey to sign
+8. Done! (Remember to answer the request in jira!)
-- 
cgit v1.2.3