Re: should Documentation/howto/setup-git-server-over-http.txt be marked obsolete?

Sitaram Chamarty [off-list ref] writes:

Subject line says it all... While working with people trying to use
gitolite's new support for the "smart HTTP" mode, I find sometimes
they get side-tracked by this document.

Not everybody uses gitolite, and I do not think we have broken the dumb
HTTP support (however broken the original was ;-) to render the document
obsolete.

Perhaps we should do three and half things:

 - The said documentation should be fine as is if the reader is trying to
   set up a dumb HTTP push support; otherwise it should be updated.

 - It would be really nice if somebody wrote a similar document describing
   how to set up a smart HTTP server, and put it next to the said
   documentation.

 - When the above two is done, insert one line "This describes an older
   way; see <<insert the name of the other document here>> for insn to set
   up an experimental smart HTTP server" at the beginning of the original
   document.

and finally:

 - On the gitolite side, refer to the "new" document in git.git
   documentation set.