This repository holds the website source code for https://w3id.org/.
The purpose of w3id.org is to provide a secure, permanent URL re-direction service for Web applications. This service is run by the W3C Permanent Identifier Community Group.
Web applications that deal with Linked Data often need to specify and use URLs that are very stable. Entities minting such URLs utilize services such as this one to ensure that applications using their URLs will always be re-directed to a working website. This website operates like a switchboard, connecting requests for information with the true location of the information on the Web. The switchboard can be reconfigured to point to a new location if the old location stops working.
A growing group of organizations has pledged responsibility to ensure the operation of this website. These organizations include Digital Bazaar, 3 Round Stones, OpenLink Software, Applied Testing and Technology, Openspring, and Bosatsu Consulting. They are responsible for all administrative tasks associated with operating the service. The social contract between these organizations gives each of them full access to all information required to maintain and operate the website. The agreement has been set up such that a number of these companies could fail, lose interest, or become unavailable for long periods of time without negatively affecting the operation of the site.
This website operates in HTTPS-only mode to ensure end-to-end security. This means that it may be used for Linked Data applications that require high levels of security such as those found in the financial, medical, and public infrastructure sectors.
All identifiers associated with this website are intended to be around for as long as the Web is around. This means decades, if not centuries. If the final destinations for popular identifiers used by this service fail in such a way as to be a major inconvenience or danger to the Web, the community will mirror the information for the popular identifiers and setup a working redirect to restore service to the rest of the Web.
For the technically savvy, the preferred way to create the redirect yourself is by following these steps:
- Fork the
perma-id/w3id.orgsource code repository. - Add a new re-direct entry. For a simple example, see
security/.htaccess - (Optional) Add a
README.mddetailing contact persons and (a subset of) your permanent identifiers. For an example, seerdw/README.md - Commit your changes and submit a pull request.
- w3id.org administrators will review your pull request and merge it if everything looks correct. Once the pull request is merged, the changes go live immediately.
You can also send a request to add a redirect to the public-perma-id@w3.org mailing list. Make sure to include the URL that you want on w3id.org, the URL that you want to redirect to, and the HTTP code that you want to use when redirecting. An administrator will then create the redirect for you.
- Do not link-squat. If you are going to claim a permanent identifier, make sure you or your organization intends for it to be around for at least 20+ years.
- Make sure the link you redirect to works. If not, we will most likely reject your requested addition.
- If you are creating a link to your personal website, please do so under
the
/people/subdirectory. A simple redirect should be placed in/people/.htaccess. A complex redirect should be placed under a directory like/people/rubarb/.htaccess.
A simple Travis-CI job
(see .travis.yml) will extract all https://w3id.org/
URIs from */README.md and check them with
linkchecker.
In theory, this will catch two kinds of errors:
- Following a redirection gives a
404 Not Found - An error in
.htaccesscauses a500 Server Error.
Note that this only checks URIs that are listed in the README.md files.
Travis might comment on your Pull Request if this test reveals an error. Check its output logs to ensure the errors are not caused by your modification.