Christian is probably more diplomatic here, but I think that... > Hello, > > Trac has a serious documentation problem. Normally I have 3 types of help > when developing software: > * documentation of the API > * examples > * help by users or developers
you forgot the first rule: help yourself by learning from the sources. > Now for Trac I have the problem, that all 3 types fail. See first rule. > - The online help on the Trac pages is mainly not existing. It well exists. Help on all end user relevant parts concerning trac is there. And info on developer related issues is already there, requiring additional documentation in the wiki for making a quick start for not so eager source readers... > - The examples may exist, but can't be found. Whenever I try Google to > find something related to Trac searching for API names or functions I > find lots of patches and bug reports, but never found anything helpful. Hm, perhaps you should define your requirements first, and after that, have a good look at the sources, prior to googling? And even if you'd google for trac * you'd find it prominently under the first 2 to N links on the first page served. To be honest, you will not find any other link on the first 2 or so pages when searching for trac on google. Did you use bing (as in chinese)? > - Asking questions on Trac-Devel seems to have no effect at all, as my > mail posted one week ago got not one reply. Hm, I just had a good look at your mail and it seems that you did not provide the information necessary to answer your first question. (1) what exactly is the code you are referring to, is it a plugin, or is it some modification to trac, or did you embed the code into the genshi template you are using? And, googling for trac add_link reveals that you might have wanted to extend upon the INavigationContributor extension point And, by having a good look at the in source documentation on that interface, would have revealed that any links you contribute to a page will automatically be rendered by the system. If you want to have more than that feel free to implement your own link providers... Now to your second question (2) where is the java plugin being hosted at? if it is different locations, i.e. <your trac>/login and <weird>/applet, then the application, in this case trac, will not allow you to connect as an authorized user due to the missing session token/id. Something which a competent developer like yourself should have figured out in the first place by pure logic. Alternatively you could have easily searched for trac + single signon which would have provided you with lots of hints on how to accomplish that. Again, this is pure logic being applied. You see, your inquiry (2) can not be answered easily by some or most of the audience as it is a very special/complicated case. To be honest, you are actually left to solve that problem by yourself, since you define the environment in which you host both the applet and the trac application. And feel free to provide your findings on the offical trac wiki, which leads us over to... > I know that documentation is always complicated problem, but if NO way to > get information really works, then the concept is flawed. Perhaps you check the way you search for things: (1) searching for 'trac' on google yields trac prominently as the first result available (2) searching for 'trac repository' on google yields the appropriate links as the first two results available (3) searching for 'trac svn'... see above (4) and even searching for INavigationContributor... see above So, you better revise your search strategy... > Since I first had contact to Trac development I have the impression, that > you actually don't want to have external developers (the admins know If you find errors, or have any proposals, feel free to provide patches and new features. In the long run, a competent developer like yourself, will actually get premium membership and full access to the repositories... I fear the regression related issues, though. > about the trouble we had until I took over SpamFilter plugin). I can't > understand this, as Trac is really a good product. So you actually do RTFM and read sources? Then, I can not understand your discomposure... -- Carsten -- You received this message because you are subscribed to the Google Groups "Trac Development" group. To post to this group, send email to trac-...@googlegroups.com. To unsubscribe from this group, send email to trac-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/trac-dev?hl=en.
