[openstack-dev] [all][heat] Which repo to use in docs -- git.openstack.org or github.com?

Flavio Percoco flavio at redhat.com
Wed Oct 21 06:27:39 UTC 2015

On 20/10/15 18:34 +0000, Jeremy Stanley wrote:
>On 2015-10-20 13:20:34 -0500 (-0500), Dolph Mathews wrote:
>> +1 I would never direct anyone new straight to git.openstack.org because it
>> makes a poor first impression relative to github.com. I assume that's the
>> reason why we keep github.com as a mirror at all (?).
>Directing someone to a proprietary/non-open service seems like a far
>worse impression to me.
>We did look into a mechanism to auto-render README pages on the fly
>in cgit, but any reasonably trivial implementation with its filter
>mechanism made it hard to get to the non-rendered version of the
>document. Ultimately we determined that putting work into making it
>easier to render and publish documentation was a far better use of
>our time than trying to turn a code browser into a documentation
>So if the question is whether to point people at git.openstack.org
>or github.com as a homepage for a project, my recommendation is:
>neither. Link them to your published documentation (and make sure it
>includes information on where to browse and clone your source

Just want to say that I fully agree with the above. Well said!

Flavio Percoco
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20151021/764a9a04/attachment.pgp>

More information about the OpenStack-dev mailing list