[Prologdoc-devel] Re: Welcome and future of PrologDoc
Status: Beta
Brought to you by:
bramadams
From: Bram A. <bra...@ug...> - 2005-06-12 21:12:12
|
Hi, Chris Mungall wrote: >The code seems very stable, and I've used it extensively > >I have a few changes I would like to commit to support codelistings (a >new @cl tag) - shall we discuss these on the prologdoc-devel list? > >You can see an example here: >http://www.fruitfly.org/~cjm/blip/pdoc/graphviz.html > >And more here: >http://www.fruitfly.org/~cjm/blip/modules.html > > Seems useful to me. What are the technical consequences, Salvador (I need to delve into the source code again ...)? >There are a few changes I'd like to see, but don't really know the code >well enough to implement - in particular, I would like to preserve the >ordering of predicates I have in my source (pdoc currently sorts these >alphabetically) - my docs often have some linear flow > > Would it be interesting to assign priorities to comments too? All comments with same priority level could be listed alphabetically (maybe with their own heading). By using a switch tag in the file comment, the relevant ordering (completely alphabetically, ordering from file or priority ordering) could be chosen. Could this behavior be implemented solely in XSLT? >I think before we have a release we need at minimum a home page that isn't >misleading. There's a chance I may be able to work on this in the next >month > > OK, it needed a revamp badly ;-)! > > >>So Salvador, can you brief us about PrologDocNGs current form and any >>necessary, but lacking features? Chris (everybody in fact), what's your >>vision about PrologDoc's future? Any other remarks (role assignment, >>collaboration model, ... )? >> >> > >I'm happy to help out coding and with documentation in so far as time >allows. I'm happier working around the edges on things such as the xslts >since I'm not familiar enough with the guts of the code to do much else >(ironically the pdoc internals could really do with a bit more >documentation!) > > Good suggestion. Salvador, if time allows, I'll try to explore the source code. Could you provide us a high-level overview of the current architecture? >Does someone want to respond to the question on the swi list? > > I think Salvador is subscribed to that mailing list. But, apparently someone else has already responded. Kind regards, Bram Adams |