On 07/18/2015 02:43 PM, hellekin wrote: > On 07/18/2015 01:33 PM, Wendy Seltzer wrote: >> >> We have https://www.torproject.org/docs/documentation.html.en#DesignDoc >> which points to >> >> https://gitweb.torproject.org/torspec.git/tree/tor-spec.txt >> https://gitweb.torproject.org/torspec.git/tree/rend-spec.txt >> etc. >> >> Do you think we need a new and different page? >> > *** Hi Wendy, > > this would provide consistent and stable URIs and demonstrate goodwill > to the IETF, that you're taking into account the "major" and "minor" > issues <corp>, using foresight to establish a long-term paradigm towards > global stability <snark>and enlightenment of all netizens <ripper>in the > purity of essence of all our precious bodily > fluids</ripper></snark></corp>*. > > In order to make referencing Tor specifications more consistent--a > pointer to a git repository is hardly seen as stable,
What if we take a versioned snapshot of the git repository -- or include the versioning hashes in the references to the git repo? The git history indicates that these files themselves are actually quite stable, we just need a way to reference these particular versions. --Wendy I recommend using > https://torproject.org/spec as a base URL, and to include the following > anchors: > > #tor-protocol > #tor-directory > #tor-control > #tor-rendezvous > #tor-path > #tor-address > #tor-socks-ext > #tor-version > > A description list could be used, e.g.: > > <dl> > <dt id="tor-protocol"><a > href="https://gitweb.torproject.org/torspec.git/tree/tor-spec.txt";>Tor-Protocol</a><dt> > <dd>This is the main specification for Tor. It describes the Tor > Protocol's current implementation.</dd> > > ... > </dl> > > Then IETF working documents could use: > > [Tor-Protocol]: https://torproject.org/spec#tor-protocol > > etc., without the need to update any published IETF documents related to > Tor even when the Tor specs have reached RFC status. Note that since > RFC 7258, there seems to be a growing interest in citing Tor in IETF > documents. :) > > Thanks! > > == > hk > > * I know, I know, the HTML spec doesn't allow snark elements within corp > elements. Take it easy :) > > _______________________________________________ > tor-dev mailing list > [email protected] > https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-dev > -- Wendy Seltzer -- [email protected] +1 617.863.0613 Policy Counsel, World Wide Web Consortium (W3C) Fellow, Berkman Center for Internet & Society at Harvard University Visiting Fellow, Yale Law School Information Society Project http://wendy.seltzer.org/ https://www.chillingeffects.org/ https://www.torproject.org/ http://www.freedom-to-tinker.com/ _______________________________________________ tor-dev mailing list [email protected] https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-dev
