I remembered this thread when I tried to use a link to <a href="http://pre.plt-scheme.org/docs/html/futures/">http://pre.plt-scheme.org/docs/html/futures/</a> and it arrived at <a href="http://pre.racket-lang.org/docs/html/futures/">http://pre.racket-lang.org/docs/html/futures/</a> with a page like this: Page not found > (uncaught-exception-handler (*(+(*)(*(+(*)(*)(*)(*)(*))(+(*)(*)(*)(*)(*))(+(*)(*)(*)(*))))(+(*)(*)(*)(*)))) uncaught exception: 404 Is it the 404 page template or really an uncaught exception? []'s Rodolfo Carvalho <div class="gmail_quote">On Sat, Jun 9, 2012 at 6:24 PM, Matthew Flatt <<a href="mailto:mflatt@cs.utah.edu" target="_blank">mflatt@cs.utah.edu</a>> wrote: <blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> <div class="im">At Sat, 09 Jun 2012 16:32:03 -0400, Neil Van Dyke wrote: > What's the best way to link to the documentation for a symbol in one of > the Racket manuals? > > Linking into the latest release public copy of the manuals on > "<a href="http://doc.racket-lang.org" target="_blank">doc.racket-lang.org</a>", here are three options, none of which seems ideal: > > 1. This works at the moment, but it's big and ugly, and I don't know > whether it will still work a few months from now: > > <a href="http://doc.racket-lang.org/planet/Developing_Packages_for_PLaneT.html?q=can-be-loade" target="_blank">http://doc.racket-lang.org/planet/Developing_Packages_for_PLaneT.html?q=can-be-loade</a> > d-with#%28idx._%28gentag._16._%28lib._planet/planet..scrbl%29%29%29 </div>As long as the section tag, identifier name, and exporting module name stay the same, that link is stable (by design, not by accident). The section tag looks to be derived from the section title in the above example. If the section title needs to change for some reason, the old title can be used for the tag to preserve old references, but that makes some attention by the document author. The original plan included setting up a server to find documentation for a binding in the same way that DrRacket finds documentation, but I think we never got to that. <div class="im"> > 2. This does not jump to "can-be-loaded-with" (the "?q=" query part of > the URL doesn't seem to be used for anything): > > <a href="http://doc.racket-lang.org/planet/Developing_Packages_for_PLaneT.html?q=can-be-loade" target="_blank">http://doc.racket-lang.org/planet/Developing_Packages_for_PLaneT.html?q=can-be-loade</a> > d-with </div>Right --- doesn't work. <div class="im"> > 3. The following one works well enough in this particular case, since > there's only one "can-be-loaded-with", but it's not as good if I want to > link to something that gives multiple search hits. Nor is it very good > if I wanted to direct people to a particular discussion, such as in the > Reference rather than the Guide, or vice versa. > > <a href="http://doc.racket-lang.org/search/index.html?q=can-be-loaded-with" target="_blank">http://doc.racket-lang.org/search/index.html?q=can-be-loaded-with</a> </div>Yep. <div class="im"> > My immediate motivation is for when McFly points users to documentation > they need to look at, such as if McFly adds a missing problematic > "can-be-loaded-with" to "info.rkt" (see below). But long-term URLs are > also good for things like linking to Racket documentation from Web > sites, printed materials, etc. that might have longevity. > > ;; TODO: See > <a href="http://doc.racket-lang.org/search/index.html?q=can-be-loaded-with" target="_blank">http://doc.racket-lang.org/search/index.html?q=can-be-loaded-with</a> > (define can-be-loaded-with 'all) </div>So far, we have mostly relied on option 1. The last two Racket blog posts, for example, include lots of links of that form. <div class="HOEnZb"><div class="h5"> ____________________ Racket Users list: <a href="http://lists.racket-lang.org/users" target="_blank">http://lists.racket-lang.org/users</a> </div></div></blockquote></div>