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?

Mike
 
 
This message posted from opensolaris.org

Reply via email to