dormando (dormando) wrote in lj_dev,
dormando
dormando
lj_dev

Zeh documentation system...

Hey all, I think I'll take a little more initiative...

So, we need a good technical documentation system...

DocBook is gigantic and funny looking, using it might simply end up confusing people. Unless I can dig enough into it to find a suitable subset, and re-document that. Which might be twice as much work as it's worth.

I'll write a DTD for XML-based lj docs, and I believe with a few examples, and with the common knowledge of HTML, this should be simple enough at first.

I'll write out some abstract scripts, one to validate and produce (as much as possible) coherent and helpful errors for the docs as they're submitted... and another to convert the docs to HTML. I'll write one or two other converters, but then I'll sit here and whine until someone else does the necessary code to convert to the other file formats other people want.

So, king of all suggestions, what is your wishlist for sections/tags in an lj documentation system?
Subscribe

  • cl-journal livejournal client

    Hey everyone, I'd like to present a livejournal client that I wrote to fulfill my needs but maybe there are other people that can find it…

  • SessionGenerate and ljloggedin

    Are there any information after release 86 and changes in cookies scheme to use sessiongenerate? It returns ljsession key, but this key is not enough…

  • Retrieving comments

    Hi, Is there a way to retrieve a list of comments made by user XXX (which may or may be not the currently logged in user) in the journals of users…

  • Post a new comment

    Error

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

    Your IP address will be recorded 

  • 15 comments

  • cl-journal livejournal client

    Hey everyone, I'd like to present a livejournal client that I wrote to fulfill my needs but maybe there are other people that can find it…

  • SessionGenerate and ljloggedin

    Are there any information after release 86 and changes in cookies scheme to use sessiongenerate? It returns ljsession key, but this key is not enough…

  • Retrieving comments

    Hi, Is there a way to retrieve a list of comments made by user XXX (which may or may be not the currently logged in user) in the journals of users…