Grin with cat attached (wechsler) wrote in lj_clients,
Grin with cat attached

Adding comments to the client protocol documentation

Most client authors willl recognise that the client protocol documentation is, shall we say, "slightly desynched" with the actual status of the protocol. Most will also recognise that it's going to take a significant effort for one person to go through and correct it.

Can I therefore suggest that something similar to the comments system for the PHP documentation is put in place? (see for an example). This lets users post notes and errata to the documentation, and can generally answer most of the questions that arise.

Of course, it also leads to some misguided comments from users who don't completely understand what they're posting about, therefore I'd suggest that any such system used for the LJ CSP be moderated.

Thoughts/ideas? Has this been proposed/done before?

  • 302: lj_dev

    In the interests of consolidating all LiveJournal development-related discussion, we're going to be closing down this community. The same…

  • Plain text to LJ

    I have an old blog from xanga that's in html/plain text and I want to move it over here. Which client would be the best to do this? I also want to…

  • ljKlient 0.2.0 Preview Release 1

    Today marks another milestone in the development of ljKlient — as the first preview of the 0.2 series is released.  Please go to the project…

  • Post a new comment


    Comments allowed for members only

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened