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

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 http://www.uk.php.net/manual/en/function.printf.php 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?
Subscribe
  • Post a new comment

    Error

    Comments allowed for members only

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

  • 4 comments