<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Oct 20, 2015 at 12:20 PM, Christopher Aedo <span dir="ltr"><<a href="mailto:doc@aedo.net" target="_blank">doc@aedo.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On Tue, Oct 20, 2015 at 3:43 AM, Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a>> wrote:<br>
> On 2015-10-20 12:17, Qiming Teng wrote:<br>
>><br>
>> Hi,<br>
>><br>
>> Just encountered this again in code review [1]. The question is about<br>
>> the repository to point to when documenting things up. Between the<br>
>> following links, which one should we use?<br>
>><br>
>> - <a href="https://git.openstack.org/cgit/openstack/sqlalchemy-migrate" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/sqlalchemy-migrate</a><br>
>> - <a href="https://github.com/openstack/sqlalchemy-migrate" rel="noreferrer" target="_blank">https://github.com/openstack/sqlalchemy-migrate</a><br>
>><br>
>> I had an impression that I saw something like 'use <a href="http://git.openstack.org" rel="noreferrer" target="_blank">git.openstack.org</a><br>
>> instead of <a href="http://github.com" rel="noreferrer" target="_blank">github.com</a> because the later is just a mirror ...' but cannot<br>
>> find the link now. Maybe it is an illusion. :)<br>
>><br>
>> So, seriously, any recommendations or guidelines?<br>
><br>
><br>
> Yes, <a href="http://git.openstack.org" rel="noreferrer" target="_blank">git.openstack.org</a> is our official server, github is just a read-only<br>
> mirror.<br>
><br>
> Linking to github might also raise the expectation that we use the usual<br>
> github workflow which is not the case,<br>
<br>
</span>I understand github is a read-only mirror and we don't want casual<br>
visitors to expect the github workflow - so in most cases I agree<br>
people should be pointed to our official server.<br>
<br>
On the other hand, the fact that github renders the README nicely<br>
(including images) leads to a much more inviting first impression.<br>
For example, for the uninitiated, this <a href="http://git.openstack.org" rel="noreferrer" target="_blank">git.openstack.org</a> URL[2]<br>
doesn't help at all if you are curious about the project, while the<br>
<a href="http://github.com" rel="noreferrer" target="_blank">github.com</a> URL[3] tells you what the project is about and even<br>
includes a few screenshots.  For purposes of learning about or<br>
understanding OpenStack I would say the <a href="http://github.com" rel="noreferrer" target="_blank">github.com</a> URL is vastly<br>
superior.<br></blockquote><div><br></div><div>+1 I would never direct anyone new straight to <a href="http://git.openstack.org">git.openstack.org</a> because it makes a poor first impression relative to <a href="http://github.com">github.com</a>. I assume that's the reason why we keep <a href="http://github.com">github.com</a> as a mirror at all (?).</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Is it crazy to suggest we do something similar with our github server?<br>
<br>
-Christopher<br>
<br>
[2]: <a href="http://git.openstack.org/cgit/openstack/app-catalog-ui/" rel="noreferrer" target="_blank">http://git.openstack.org/cgit/openstack/app-catalog-ui/</a><br>
[3]: <a href="https://github.com/openstack/app-catalog-ui" rel="noreferrer" target="_blank">https://github.com/openstack/app-catalog-ui</a><br>
<br>
><br>
> Andreas<br>
><br>
>> [1] <a href="https://review.openstack.org/#/c/237404/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/237404/</a><br>
<div class="HOEnZb"><div class="h5"><br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div></div>