Open Stack

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
>viewer.
>
>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
>code!).

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

-- 
@flaper87
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>