On Tue, Jan 22, 2008 at 03:37:48PM -0800, Mike Pogue wrote:
> Hey, everybody!
>
> There is a bug open on DTrace (6558281 P2 bad url in dtrace script(s?)) that
> boils down to making a URL reference in code to documentation that has moved.
> So, the permalink turned out to be "not so perma". :-)
>
> Now, we'll fix this particular case (one way or another), but it does bring
> up the larger issue of permalinks, and not just doc->doc, but also code->doc.
> Links going from docs -> code seem like a pretty safe thing to do in
> practice, but given that docs can and do change (or move around) more
> frequently than code does, how much should we encourage/discourage links the
> other direction, from code -> docs? Or, alternately, is there a need for
> more stable links into the docs? How do other projects solve this?
Well, the way to fix that one is to give each document a permanent part
number for the latest revision, or even to not remove old content from
docs.sun.com.
I also very much like sun.com/msg.
Ceri
--
That must be wonderful! I don't understand it at all.
-- Moliere
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL:
<http://mail.opensolaris.org/pipermail/docs-discuss/attachments/20080123/6f5332b2/attachment.bin>
