Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Descriptive content #17

Merged
merged 25 commits into from
Oct 31, 2022
Merged
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
b76c752
Update editors and authors, using w3cid. Adds @gkellogg, removes @msp…
gkellogg Oct 17, 2022
26c6531
Normalize spec references.
gkellogg Oct 17, 2022
73ff09d
Reference specific issues with some issues in the spec.
gkellogg Oct 17, 2022
6256e6a
Move localBiblio to a common file.
gkellogg Oct 17, 2022
2668a34
Add typographical conventions.
gkellogg Oct 17, 2022
850f9c2
Add explicit section identifiers, updating some references.
gkellogg Oct 17, 2022
d2b6bfe
Minor intro updates.
gkellogg Oct 17, 2022
a21bd11
Add some descriptive information from the Arnold/Longley paper.
gkellogg Oct 17, 2022
9d55dc7
Add Manu as formerEditor (CG Report).
gkellogg Oct 19, 2022
6aea3cb
Improvements to typographical-conventions.
gkellogg Oct 20, 2022
1cfe656
Apply suggestions from code review
gkellogg Oct 20, 2022
ba97d6d
Update spec/common/typographical-conventions.html
gkellogg Oct 20, 2022
bd8a736
Update algorithm structure, including adding unique identifiers for e…
gkellogg Oct 20, 2022
f0c7060
Define "lexicographically ordered" and some other definitions.
gkellogg Oct 20, 2022
46f537d
Narrative updates.
gkellogg Oct 20, 2022
6521f41
Update spec/index.html
gkellogg Oct 20, 2022
1ec24fc
Add issue marker for definition of lexicographical ordering.
gkellogg Oct 21, 2022
cd63efa
Describe "lexicographical order" using XPATH-FUNCTIONS `fn:compare` u…
gkellogg Oct 26, 2022
244d84e
Apply suggestions from code review
gkellogg Oct 26, 2022
fb32054
"lexicographically-sorted" => "lexicographically sorted"
gkellogg Oct 26, 2022
8b5b612
Add issue-summary secction.
gkellogg Oct 26, 2022
9e9cbe3
Update spec/index.html
gkellogg Oct 26, 2022
c733ed5
Change "lexicographical ordering" to "Unicode point ordering", with a…
gkellogg Oct 31, 2022
bdfb347
Apply suggestions from code review
gkellogg Oct 31, 2022
e4f5846
"shortest1" => "shortest".
gkellogg Oct 31, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions spec/common/biblio.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
const rch = {
// Add as the respecConfig localBiblio variable
// Extend or override global respec references
localBiblio: {
"CCG-RDC-FINAL": {
id: "CCG-RDC-FINAL",
title: "RDF Dataset Canonicalization",
authors: ["Dave Longley"],
editors: [
"Dave Longley",
"Manu Sporny"
],
date: "2022-10-09",
href: "https://www.w3.org/community/reports/credentials/CG-FINAL-rdf-dataset-canonicalization-20221009/",
status: "CG-FINAL",
publisher: "W3C"
},
"DesignIssues-Diff": {
id: "DesignIssues-Diff",
title: "Delta: an ontology for the distribution of differences between RDF graphs",
authors: ["Tim Berners-Leee"],
date: "2015-09-25",
href: "https://www.w3.org/DesignIssues/Diff",
status: "unofficial",
publisher: "W3C"
},
"eswc2014Kasten": {
id: "eswc2014Kasten",
title: "A Framework for Iterative Signing of Graph Data on the Web",
authors: ["Andreas Kasten", "Ansgar Scherp", "Peter Schauß "],
date: "2014",
href: "https://doi.org/10.1007/978-3-319-07443-6_11",
status: "unofficial",
publisher: "ISWC 2014"
},
"Hogan-Canonical-RDF": {
id: "Hogan-Canonical-RDF",
title: "Canonical Forms for Isomorphic and Equivalent RDF Graphs: Algorithms for Leaning and Labelling Blank Nodes",
authors: ["Aiden Hogan"],
date: "2017-07-17",
href: "https://aidanhogan.com/docs/rdf-canonicalisation.pdf",
status: "unofficial",
publisher: "ACM Transactions on the Web"
},
"HPL-2003-142": {
id: "HPL-2003-142",
title: "Signing RDF Graphs",
authors: ["Jeremy J. Carroll"],
date: "2003-07-23",
href: "https://www.hpl.hp.com/techreports/2003/HPL-2003-142.pdf",
publisher: "HP Laboratories Bristol",
status: "unofficial"
}
}
};
46 changes: 46 additions & 0 deletions spec/common/typographical-conventions.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
<p>The following typographic conventions are used in this specification:</p>

<dl class="typography">
<dt><code>markup</code></dt><dd>
Markup (elements, attributes, properties),
machine processable values (string, characters, media types),
property names,
and file names are in red-orange monospace font.</dd>
<dt><var>variable</var></dt><dd>
A variable in pseudo-code or in an algorithm description is italicized.</dd>
<dt><dfn data-no-xref="">definition</dfn></dt><dd>
A definition of a term, to be used elsewhere in this or other specifications,
is italicized and in bold.</dd>
<dt><a data-lt="definition">definition reference</a></dt><dd>
A reference to a definition <em>in this document</em>
is underlined and is also an active link to the definition itself. </dd>
<dt><a data-lt="definition"><code>markup definition reference</code></a></dt><dd>
References to a definition <em>in this document</em>,
when the reference itself is also a markup, is underlined,
in a red-orange monospace font, and is also an active link to the definition itself.</dd>
<dt><a class="externalDFN">external definition reference</a></dt><dd>
A reference to a definition <em>in another document</em>
is underlined and italicized, and is also an active link to the definition itself.</dd>
<dt><a class="externalDFN"><code> markup external definition reference</code></a></dt><dd>
A reference to a definition <em>in another document</em>,
when the reference itself is also a markup,
is underlined and italicized in a red-orange monospace font,
and is also an active link to the definition itself.</dd>
<dt><a href="">hyperlink</a></dt><dd>
A hyperlink is underlined and in blue.</dd>
<dt>[<a href="">reference</a>]</dt><dd>
A document reference (normative or informative) is enclosed in square brackets
and links to the references section.</dd>
</dl>

<p class="note">Notes are in light green boxes with a green left border and with a "Note" header in green.
Notes are always informative.</p>

<pre class="example nohighlight">
Examples are in light khaki boxes, with khaki left border,
and with a numbered "Example" header in khaki.
Examples are always informative. The content of the example is in monospace font and may be syntax colored.

Examples may have tabbed navigation buttons
to show the results of transforming an example into other representations.
</pre>
Loading