Chad J wrote: > Lars Ivar Igesund wrote: >> Dear D community >> >> ------ >> >> Signed, >> >> The Tango Team >> > (Also Jacob commented on the docs.) > > I'll give some critique on the new dil-generated docs as well. > > I'm looking at these two links: > http://www.dsource.org/projects/tango/docs/0.99.8/ > http://dil.googlecode.com/svn/doc/Tango_0.99.7/tango.text.xml.Document.html > > I'm assuming the latter are an older version of dil/kandil?.
I think so yes (at least a few patches difference). > I was a bit annoyed by the API/Modules modality in the latter docs. > It'd be nice if the "Modules" list became collapsible and put the API > elements as children of each module. It seems the newer(?) version of > the docs is collapsible, but has yet to eliminate the modality. The > newer version is tolerable though since it doesn't just hijack the frame > when I click on a module. It made me have to navigate back to the > "Modules" mode every time I wanted to go to a different module. So > yeah, forced modality here is a bad thing. I'd prefer to just get rid > of the modality entirely and merge it all into one collapsible index. Not sure it is feasible to put _all_ public Tango symbols in the same tree, JS performance seems to very quickly become a potential issue. In that case the modality is a very acceptable workaround IMO. Feel free to work with Aziz on it though. Or create ticket(s). > Also, it seems dil has yet to make types found in the documentation act > as hyperlinks to their definitions or at least module of definition. > This one is big for me. I'm hoping it's been planned. Not sure what you mean here -if you mean that a return type should link to the docs of that type, then yes, that is something that we very much want but that requires more semantic processing than dil currently has. > Other than that I like the new docs, and I like how progress is being > made on more intelligent generated docs. That I can at least click on > things and see how they are defined in code is rather useful, especially > given all the trickery D can play with its type system. Good job! > > - Chad -- Lars Ivar Igesund blog at http://larsivi.net DSource, #d.tango & #D: larsivi Dancing the Tango