On 05/05/2009, at 1:53 AM, Tom Faulhaber wrote:
> Antony: There is a way for authors to add links either to other pages > in the wiki or externally. See DataLog and Monad for examples of how > this works. One of the issues here is that doc strings are repurposed > in a lot of ways and authors generally only want to write docs once so > we need to keep the formatting very simple and not assume that folks > will be reading the docs on the wiki. The problem with relying on links is that it separates the documentation from the code - the documentation is less likely to be written and maintained if it's not right there, with the source files, and that's ignoring the issues of tool support and version control. Antony Blakey ------------- CTO, Linkuistics Pty Ltd Ph: 0438 840 787 In anything at all, perfection is finally attained not when there is no longer anything to add, but when there is no longer anything to take away. -- Antoine de Saint-Exupery --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/clojure?hl=en -~----------~----~----~----~------~----~------~--~---
