search

urbanobservatory / standards

Standards and schema documentation for the observatories programme
2 stars 0 forks source link

Format for full-length resources' URI #9

Open EttoreHector opened 5 years ago

EttoreHector commented 5 years ago

Newbie question:

When specifying a resource URI in full length, what is the recommended format? For example, shall we use http://www.w3.org/ns/ssn/Deployment or http://www.w3.org/ns/ssn/#Deployment (with the hash)?

SiBell commented 5 years ago

I'd say it's without the hash, as this is the format of the IRIs they show:

Screenshot 2019-07-19 at 13 08 05

And in their examples they don't include the hash when defining the sosa and ssn prefixes:

Screenshot 2019-07-19 at 13 07 40

It is confusing though, as all the links on the page use the hash.

lukeshope commented 5 years ago

In this case, just use the namespace the standard itself references at the start.

The namespace for SSN terms is http://www.w3.org/ns/ssn/. 
The namespace for SOSA terms is http://www.w3.org/ns/sosa/.

The above namespaces are set up to comply with this guidance. This means it returns a 303 for /ns/ssn/anything, pointing at the main namespace /ns/ssn for clients requesting something RDFy. Browsers asking for HTML are sent to the documentation, which is nice.