{
  "title": "Cite what you actually used — Standards & citation",
  "text": "MODAVIS (2026). Cite what you actually used — Standards & citation. Research notebooks, September 2026 · expanded edition. https://modavis.org/editions/2026-09-r3/standards/citing/",
  "bibtex": "@misc{modavis_standards_citing_2026_09_r3,\n  author = {{MODAVIS}},\n  title = {Cite what you actually used — Standards & citation},\n  year = {2026},\n  month = {09},\n  version = {2026-09-r3},\n  url = {https://modavis.org/editions/2026-09-r3/standards/citing/},\n  note = {Content SHA-256: 29677a84576b342a6f97d539ae8455fd889703479165b60b6725dcf03f072947}\n}",
  "url": "https://modavis.org/editions/2026-09-r3/standards/citing/",
  "sha256": "29677a84576b342a6f97d539ae8455fd889703479165b60b6725dcf03f072947",
  "edition": "2026-09-r3",
  "date": "2026-09-26",
  "canonicalPayload": "{\"book\":{\"number\":\"08\",\"slug\":\"standards\",\"title\":\"Standards & citation\"},\"chapter\":{\"blocks\":[{\"id\":\"notebook-citation\",\"text\":\"Citing a notebook page\",\"type\":\"heading\"},{\"text\":\"Use “Cite this page” in any notebook to obtain its edition URL, access-ready reference and BibTeX record. The edition URL identifies the fixed content snapshot. The SHA-256 fingerprint identifies the structured page content and its bibliographic context.\",\"type\":\"p\"},{\"text\":\"The fingerprint covers the edition identifier, publication date, notebook identity and the complete chapter, including references and the exact definitions of its diagrams. It does not cover the surrounding site design, external websites or files reached through links.\",\"type\":\"p\"},{\"text\":\"These pages provide versioned local editions. A repository deposit and DOI would add independent archival persistence; this website does not claim that its notebook editions have already been deposited.\",\"title\":\"An edition URL is not a DOI\",\"type\":\"note\"},{\"id\":\"resource-citation\",\"text\":\"Citing the research resource\",\"type\":\"heading\"},{\"text\":\"For an analysis of POD, cite the exact dataset version. For an implementation of VAO, cite the specification version. A citation of an explanatory notebook helps readers follow your reasoning, but does not substitute for either of those references.\",\"type\":\"p\"},{\"id\":\"citation-matrix\",\"text\":\"Match the citation to the work performed\",\"type\":\"heading\"},{\"headers\":[\"You used…\",\"Cite…\",\"Also record…\"],\"rows\":[[\"An explanatory chapter\",\"Its fixed notebook edition.\",\"The relevant section and any underlying evidence used.\"],[\"POD records in an analysis\",\"The exact POD version.\",\"Distribution, selection, query and checksum.\"],[\"A software method\",\"The exact application or tool release.\",\"Parameters, environment and input identities.\"],[\"A VAO object\",\"The instrument-package release.\",\"Standard contract, selected resources and client version where relevant.\"],[\"A specification or vocabulary\",\"Its immutable version record.\",\"The profile, term or constraint used.\"]],\"type\":\"table\"},{\"id\":\"version-doi\",\"text\":\"Why a version DOI matters\",\"type\":\"heading\"},{\"text\":\"A project or concept record may group successive releases. For a reproducible reference, use the identifier that fixes the version you actually used. A community link helps a reader discover related work but does not identify a unique input. Keep the human-readable citation and the machine-readable identifiers together so the reference remains interpretable outside the original application.\",\"type\":\"p\"},{\"id\":\"checksum-and-citation\",\"text\":\"A checksum complements a citation\",\"type\":\"heading\"},{\"text\":\"The digest answers whether a particular sequence of bytes or canonical structured content matches a recorded identity. It does not identify an author by itself, explain why a transformation was made or guarantee that an external service will remain online. Those needs are met by the citation, provenance, release documentation and preservation arrangements working together.\",\"type\":\"p\"},{\"text\":\"For this site, the downloadable metadata contains the exact canonical string that was hashed. Compare its recomputed digest with the recorded SHA-256 and retain the edition URL. If an external dataset or recording underpins the result, verify that artifact separately: the notebook’s fingerprint covers its own content and references, not the remote bytes behind each link.\",\"type\":\"p\"},{\"items\":[{\"detail\":\"The fixed dataset release, methods and checksums.\",\"href\":\"https://doi.org/10.5281/zenodo.22308263\",\"label\":\"Pipe Organ Dataset 1.6.0\"},{\"detail\":\"The versioned specification and reference tools.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"The published semantic model.\",\"href\":\"https://doi.org/10.5281/zenodo.22126086\",\"label\":\"MODAVIS Ontology Network 0.1.0\"}],\"type\":\"links\"}],\"intro\":\"A notebook page, a software tool and a dataset are different research resources.\",\"slug\":\"citing\",\"sources\":[{\"detail\":\"The versioned specification and reference tools.\",\"href\":\"https://doi.org/10.5281/zenodo.22214248\",\"label\":\"VAO Standard 0.5.0\"},{\"detail\":\"The fixed dataset release, methods and checksums.\",\"href\":\"https://doi.org/10.5281/zenodo.22308263\",\"label\":\"Pipe Organ Dataset 1.6.0\"}],\"title\":\"Cite what you actually used\"},\"date\":\"2026-09-26\",\"edition\":\"2026-09-r3\",\"figures\":{}}",
  "payload": {
    "edition": "2026-09-r3",
    "date": "2026-09-26",
    "book": {
      "slug": "standards",
      "title": "Standards & citation",
      "number": "08"
    },
    "chapter": {
      "slug": "citing",
      "title": "Cite what you actually used",
      "intro": "A notebook page, a software tool and a dataset are different research resources.",
      "blocks": [
        {
          "type": "heading",
          "text": "Citing a notebook page",
          "id": "notebook-citation"
        },
        {
          "type": "p",
          "text": "Use “Cite this page” in any notebook to obtain its edition URL, access-ready reference and BibTeX record. The edition URL identifies the fixed content snapshot. The SHA-256 fingerprint identifies the structured page content and its bibliographic context."
        },
        {
          "type": "p",
          "text": "The fingerprint covers the edition identifier, publication date, notebook identity and the complete chapter, including references and the exact definitions of its diagrams. It does not cover the surrounding site design, external websites or files reached through links."
        },
        {
          "type": "note",
          "title": "An edition URL is not a DOI",
          "text": "These pages provide versioned local editions. A repository deposit and DOI would add independent archival persistence; this website does not claim that its notebook editions have already been deposited."
        },
        {
          "type": "heading",
          "text": "Citing the research resource",
          "id": "resource-citation"
        },
        {
          "type": "p",
          "text": "For an analysis of POD, cite the exact dataset version. For an implementation of VAO, cite the specification version. A citation of an explanatory notebook helps readers follow your reasoning, but does not substitute for either of those references."
        },
        {
          "type": "heading",
          "text": "Match the citation to the work performed",
          "id": "citation-matrix"
        },
        {
          "type": "table",
          "headers": [
            "You used…",
            "Cite…",
            "Also record…"
          ],
          "rows": [
            [
              "An explanatory chapter",
              "Its fixed notebook edition.",
              "The relevant section and any underlying evidence used."
            ],
            [
              "POD records in an analysis",
              "The exact POD version.",
              "Distribution, selection, query and checksum."
            ],
            [
              "A software method",
              "The exact application or tool release.",
              "Parameters, environment and input identities."
            ],
            [
              "A VAO object",
              "The instrument-package release.",
              "Standard contract, selected resources and client version where relevant."
            ],
            [
              "A specification or vocabulary",
              "Its immutable version record.",
              "The profile, term or constraint used."
            ]
          ]
        },
        {
          "type": "heading",
          "text": "Why a version DOI matters",
          "id": "version-doi"
        },
        {
          "type": "p",
          "text": "A project or concept record may group successive releases. For a reproducible reference, use the identifier that fixes the version you actually used. A community link helps a reader discover related work but does not identify a unique input. Keep the human-readable citation and the machine-readable identifiers together so the reference remains interpretable outside the original application."
        },
        {
          "type": "heading",
          "text": "A checksum complements a citation",
          "id": "checksum-and-citation"
        },
        {
          "type": "p",
          "text": "The digest answers whether a particular sequence of bytes or canonical structured content matches a recorded identity. It does not identify an author by itself, explain why a transformation was made or guarantee that an external service will remain online. Those needs are met by the citation, provenance, release documentation and preservation arrangements working together."
        },
        {
          "type": "p",
          "text": "For this site, the downloadable metadata contains the exact canonical string that was hashed. Compare its recomputed digest with the recorded SHA-256 and retain the edition URL. If an external dataset or recording underpins the result, verify that artifact separately: the notebook’s fingerprint covers its own content and references, not the remote bytes behind each link."
        },
        {
          "type": "links",
          "items": [
            {
              "label": "Pipe Organ Dataset 1.6.0",
              "href": "https://doi.org/10.5281/zenodo.22308263",
              "detail": "The fixed dataset release, methods and checksums."
            },
            {
              "label": "VAO Standard 0.5.0",
              "href": "https://doi.org/10.5281/zenodo.22214248",
              "detail": "The versioned specification and reference tools."
            },
            {
              "label": "MODAVIS Ontology Network 0.1.0",
              "href": "https://doi.org/10.5281/zenodo.22126086",
              "detail": "The published semantic model."
            }
          ]
        }
      ],
      "sources": [
        {
          "label": "VAO Standard 0.5.0",
          "href": "https://doi.org/10.5281/zenodo.22214248",
          "detail": "The versioned specification and reference tools."
        },
        {
          "label": "Pipe Organ Dataset 1.6.0",
          "href": "https://doi.org/10.5281/zenodo.22308263",
          "detail": "The fixed dataset release, methods and checksums."
        }
      ]
    },
    "figures": {}
  }
}