Merge pull request #306 from grnet/fix-adr-readme-publishing

Fix ADR README publishing

Author: Saramandus

adr/001-replace-lpid-with-ebwoid.md

@@ -3,7 +3,7 @@
 **Authors:**
 - Erwin Nieuwlaar, KVK, Netherlands
 
-## Context:
+## Context
 In webuild-consortium/eudi-wallet-rulebooks-and-schemas#24, the LPID (Legal Person Identification Data) rulebook was removed in favour of the EBWOID (European Business Wallet Owner Identification Data) rulebook. It was unclear whether this represented a consortium decision. Hence, an ADR to discuss support/objections and document this decision is clearly.
 The PID/EBWOID working group agreed to proceed with this change during a weekly discussion session.
 

adr/README.md

@@ -32,8 +32,10 @@ Propose new ADRs using the [template](_template.md). Announce them to the [Archi
 
 ## Supporting analysis
 
+<!--BEGIN INDEX-->
 - [Attestations, Documents and Data Analysis](build-document-vs-attestation-analysis.md)
 - [EDD Identification, Discovery and Connection Analysis](build-edd-identification-discovery-connection-analysis.md)
+<!--END INDEX-->
 
 ## ADR process for WE BUILD
 

blueprint/.gitignore

@@ -1,5 +1,6 @@
 *~
 *.html
+appendix-adr.md
 cs-*.md
 cs-*.qmd
 quarto-*.deb

blueprint/appendix-adr.md

@@ -72,14 +72,15 @@ def get_indexed_mds(index_file: str) -> list[str]:
 
 def generate_adr_appendix():
     print("Generating ADR appendix...")
-    generate_qmd("appendix-adr.md", numbered=True)
     base_path = "../adr/"
-    adr_mds = get_indexed_mds(base_path + "README.md")
+    shutil.copy(base_path + "README.md", "appendix-adr.md")
+    generate_qmd("appendix-adr.md", numbered=True)
+    adr_mds = get_indexed_mds("appendix-adr.md")
     with open("appendix-adr.qmd", "a") as adr_appendix_qmd:
         for adr_md in adr_mds:
             print("Found ADR:", adr_md)
             shutil.copy(base_path + adr_md, adr_md)
-            include(adr_appendix_qmd, generate_qmd(adr_md, numbered=True), indent=1)
+            REFS.append(generate_qmd(adr_md, numbered=True))
     print()