[Prologdoc-devel] Re: Welcome and future of PrologDoc

[Bram A. <bra...@ug...>]

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