Skip to content

Commit

Permalink
Clarify server and client notification-channel-discovery.
Browse files Browse the repository at this point in the history
Issue #58
  • Loading branch information
csarven committed Nov 8, 2022
1 parent a4d1261 commit 9379d81
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions protocol.html
Original file line number Diff line number Diff line change
Expand Up @@ -504,6 +504,8 @@ <h3 property="schema:name">Discovery</h3>
<section id="notification-channel-discovery" inlist="" rel="schema:hasPart" resource="#notification-channel-discovery">
<h4 property="schema:name">Notification Channel Discovery</h4>
<div datatype="rdf:HTML" property="schema:description">
<p>Server supports discovery of Notification Channels through the use of Link headers. Clients can discover Notification Channel information available to a given resource or to a storage as follows:</p>

<p about="" id="server-link-resource-notification-channel" rel="spec:requirement" resource="#server-link-resource-notification-channel"><span property="spec:statement">When a server wants to enable applications to discover <a href="#notification-channel">Notification Channels</a> available to a given <a href="https://solidproject.org/TR/protocol#resource">resource</a>, the <span rel="spec:requirementSubject" resource="spec:Server">server</span> <span rel="spec:requirementLevel" resource="spec:MUST">MUST</span> advertise the associated resources describing the channel information by responding to an HTTP request including a <code>Link</code> header with the <code>rel</code> value of <code>describedby</code> [<cite><a class="bibref" href="#bib-powder-dr">POWDER-DR</a></cite>] and the Description Resource as link target [<cite><a class="bibref" href="#bib-rfc8288">RFC8288</a></cite>].</span></p>

<p about="" id="server-link-storage-notification-channel" rel="spec:requirement" resource="#server-link-storage-notification-channel"><span property="spec:statement">When a server wants to enable applications to discover <a href="#notification-channel">Notification Channels</a> available to a <a href="https://solidproject.org/TR/protocol#storage">storage</a> in which a given <a href="https://solidproject.org/TR/protocol#resource">resource</a> is in, the <span rel="spec:requirementSubject" resource="spec:Server">server</span> <span rel="spec:requirementLevel" resource="spec:MUST">MUST</span> advertise the associated resources describing the channel information by responding to an HTTP request including a <code>Link</code> header with the <code>rel</code> value of <code>http://www.w3.org/ns/solid#storageDescription</code> [<cite><a class="bibref" href="#bib-solid-protocol">SOLID-PROTOCOL</a></cite>] and the Description Resource as link target [<cite><a class="bibref" href="#bib-rfc8288">RFC8288</a></cite>].</span></p>
Expand Down

0 comments on commit 9379d81

Please sign in to comment.