add initial citation; reduce section on pandoc; tighten references

1 files changed, 47 insertions, 32 deletions

diff --git a/ref.bib b/ref.bib
index 947c3ab..8cddd64 100644
--- a/ref.bib
+++ b/ref.bib
@@ -58,12 +58,23 @@
   institution = {Internet Engineering Task Force},
 }
 
-@Electronic{Gruber2004,
-  author  = {John Gruber},
-  date    = {2004-12-17},
-  title   = {Markdown},
-  url     = {https://daringfireball.net/projects/markdown/},
-  urldate = {2025-02-18},
+@Online{Gruber2004,
+  author       = {John Gruber},
+  date         = {2004-12-17},
+  title        = {Markdown},
+  url          = {https://daringfireball.net/projects/markdown/},
+  organization = {{Daring Fireball}},
+  urldate      = {2025-02-18},
+}
+
+@Online{Gruber2004syntax,
+  author       = {John Gruber},
+  date         = {2004},
+  title        = {Markdown},
+  url          = {https://daringfireball.net/projects/markdown/syntax},
+  organization = {{Daring Fireball}},
+  subtitle     = {Syntax},
+  urldate      = {2025-05-19},
 }
 
 @Book{Leonard2016,
@@ -74,7 +85,7 @@
   institution = {Internet Engineering Task Force},
 }
 
-@Electronic{Heesch2025,
+@Online{Heesch2025,
   author   = {Dimitri van Heesch},
   date     = {2025-01-09},
   title    = {Doxygen},
@@ -83,15 +94,16 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{Github2025,
+@Online{Github2025,
   date         = {2025-02-18},
   editor       = {{Github, Inc.}},
+  title        = {About {READMEs}},
   url          = {https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes},
   organization = {GitHub, Inc.},
   urldate      = {2025-02-18},
 }
 
-@Electronic{GitLab2025,
+@Online{GitLab2025,
   author       = {{GitLab Inc.}},
   date         = {2025-02-17},
   title        = {GitLab Flavored Markdown (GLFM)},
@@ -100,7 +112,7 @@
   urldate      = {2025-02-18},
 }
 
-@Electronic{Codeberg2024,
+@Online{Codeberg2024,
   author   = {{Codeberg Docs Contributors}},
   date     = {2024-11-29},
   title    = {Your First Repository},
@@ -109,7 +121,7 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{Oracle2025,
+@Online{Oracle2025,
   author   = {{Oracle}},
   date     = {2025-01-25},
   title    = {JavaDoc Guide},
@@ -118,7 +130,7 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{RustTeam2024,
+@Online{RustTeam2024,
   author   = {{the Rust Team}},
   date     = {2024-04-04},
   title    = {The rustdoc book},
@@ -127,7 +139,7 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{Sphinx2025,
+@Online{Sphinx2025,
   author   = {{the Sphinx developers}},
   date     = {2025-01-29},
   title    = {Sphinx documentation},
@@ -136,7 +148,7 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{JSDoc2023,
+@Online{JSDoc2023,
   author   = {{the contributors to JSDoc}},
   date     = {2023-10-31},
   title    = {Use JSDoc},
@@ -145,9 +157,9 @@
   urldate  = {2025-02-18},
 }
 
-@Electronic{Microsoft2023,
+@Online{Microsoft2023,
   date     = {2023-07-12},
-  editor   = {Microsoft},
+  editor   = {{Microsoft}},
   title    = {docfx},
   url      = {https://dotnet.github.io/docfx/docs/basic-concepts.html},
   subtitle = {Basic Concepts},
@@ -182,25 +194,28 @@
   journaltitle = {Lecture Notes in Computer Science},
 }
 
-@Misc{Herman2015,
-  date     = {2015-03-17},
-  editor   = {Ivan Herman and Ben Adida and Manu Sporny and Mark Birbeck},
-  title    = {RDFa 1.1 Primer - Third Edition},
-  language = {English},
-  subtitle = {Rich Structured Data Markup for Web Documents},
-  url      = {https://www.w3.org/TR/rdfa-primer/},
-  urldate  = {2025},
+@TechReport{Herman2015,
+  date        = {2015-03-17},
+  institution = {{W3C}},
+  title       = {RDFa 1.1 Primer - Third Edition},
+  language    = {English},
+  subtitle    = {Rich Structured Data Markup for Web Documents},
+  url         = {https://www.w3.org/TR/rdfa-primer/},
+  urldate     = {2025},
+  version     = {3},
+  editor      = {Ivan Herman and Ben Adida and Manu Sporny and Mark Birbeck},
 }
 
-@Article{Francart2020,
-  author = {Thomas Francart},
-  date   = {2020-02-20},
-  title  = {Semantic Markdown Specifications},
-  editor = {sparna},
-  url    = {https://blog.sparna.fr/2020/02/20/semantic-markdown/},
+@Online{Francart2020,
+  author       = {Thomas Francart},
+  date         = {2020-02-20},
+  title        = {Semantic Markdown Specifications},
+  url          = {https://blog.sparna.fr/2020/02/20/semantic-markdown/},
+  organization = {{Sparna}},
+  urldate      = {2025-05-19},
 }
 
-@Misc{Smedegaard2022,
+@Online{Smedegaard2022,
   author = {Jonas Smedegaard and Thomas Francart},
   date   = {2022-04-09},
   editor = {Jonas Smedegaard},
@@ -208,7 +223,7 @@
   url    = {https://source.jones.dk/semantic-markdown/about/},
 }
 
-@Misc{Daquino2023,
+@Article{Daquino2023,
   author    = {Daquino, Marilena and Massari, Arcangelo and Peroni, Silvio and Shotton, David},
   date      = {2023},
   title     = {The OpenCitations Data Model},