From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 22 Oct 2010 04:23:35 GMT
Subject: Re: should Documentation/howto/setup-git-server-over-http.txt be marked obsolete?
Message-ID: <7vsjzyrh2w.fsf@alter.siamese.dyndns.org>
In-Reply-To: <AANLkTimJe9vEUwWM482NLmfHGYjnsKD5RAryQO=Zyqjj@mail.gmail.com>

Sitaram Chamarty <sitaramc@gmail.com> 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.