iain duncan schrieb: > Curious about how people using svn and trac deal with their auto > generated docs. Do you put them in a directory that goes in the > repository or just make then after checking out? Where do you usually > put that doc directory? > I'm usually a "what can get generated shouldn't be part of the repository"-guy - but docs are an exception of that rule.
The reason is simple: installing epydoc and such (maybe even with specialized styles) is an extra effort, so somebody downloading your code would either be forced to go and install it because you require it, or end up without docs if you don't. Which I think isn't too good either, because having some api-docs to rummage through is certainly helpful - if not, you could as well omit them... So for docs: they go into the rep. > Lastly, anyone have any tips for integrating epydoc with trac for tg > project? Still trying to figure out where to put everything the best > way. No. Might be worth a plugin for trac to serve certain repostory paths as static content. Diez --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears" 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/turbogears?hl=en -~----------~----~----~----~------~----~------~--~---
