Add some initial comments for servers and requirements (#75)

Author: edwardsph

CHANGELOG.md

@@ -1,5 +1,8 @@
 # Solid Specification Conformance Tests
 
+## Release 0.0.10
+* Add some initial comments for servers (in test-subjects.ttl) and requirements (in ./{spec}/requirement-comments.ttl).
+
 ## Release 0.0.9
 * Remove unused converted tests.
 * Add data driven tests for reading protected resources.

application.yaml

@@ -4,11 +4,13 @@ sources:
   # Ecosystem Proposal (Version 0.9.0 - https://solidproject.org/TR/2021/protocol-20211217)
   - https://solidproject.org/TR/protocol
   - https://github.com/solid/specification-tests/blob/main/protocol/solid-protocol-test-manifest.ttl
+  - https://github.com/solid/specification-tests/blob/main/protocol/requirement-comments.ttl
 
   # WAC spec & manifest
   # Editor's draft (fully annotated)
   - https://solid.github.io/web-access-control-spec/
   - https://github.com/solid/specification-tests/blob/main/web-access-control/web-access-control-test-manifest.ttl
+  - https://github.com/solid/specification-tests/blob/main/web-access-control/requirement-comments.ttl
 
   # Published draft (not annotated)
 #  - https://solidproject.org/TR/2021/wac-20210711

protocol/requirement-comments.ttl

@@ -0,0 +1,8 @@
+prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
+prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+prefix xsd: <http://www.w3.org/2001/XMLSchema#>
+
+prefix sopr: <https://solidproject.org/TR/protocol#>
+
+sopr:server-representation-turtle-jsonld rdfs:comment "Note that there is no requirement to support RDFa in a similar way, though some implementations may choose to."@en .
+sopr:server-wac rdfs:comment "Publicly accessible versions of ESS implement ACP for access control in place of WAC."@en .

run.sh

@@ -165,7 +165,7 @@ fi
 # extract subject
 subject=$1
 outdir=$subject
-if [ -z ${envfile+x} ]
+if [ -z ${envfile} ]
 then
   envfile="${subject}.env"
 fi

test-subjects.ttl

@@ -19,7 +19,9 @@
     doap:description "A production-grade Solid server produced and supported by Inrupt."@en ;
     doap:programming-language "Java"@en ;
     solid-test:skip "wac", "wac-allow-public", "publicagent" ;
-    solid-test:features "acp-legacy" .
+    solid-test:features "acp-legacy" ;
+    rdfs:comment "This version of ESS implements ACP for access control instead of WAC. Whilst it does not therefore conform to that aspect of the specification the access control tests are still run in order to assess the equivalent capabilities in this implementation."@en ;
+    rdfs:comment "Access for anonymous users is not supported nor required by Solid specifications so tests that depend on this are not run."@en.
 
 <ess#test-subject-release>
     doap:revision "1.1.6";

web-access-control/requirement-comments.ttl

@@ -0,0 +1,6 @@
+prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
+prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+prefix xsd: <http://www.w3.org/2001/XMLSchema#>
+
+prefix wac: <https://solid.github.io/web-access-control-spec/#>
+