<div dir="ltr"><div><div>Hi, Andreas,<br><br>What does import mean? Is it fixed in 
specific api project firstly, then we sync that content to api-site 
project, just as what we're doing to oslo<->service projects?<br>
<br></div>If it is this situation, could we develope (or it would be 
really nice to already have) utilities to automatically do this to avoid
 problem caused by labor work? If not, which means we just modify two 
copies, how could we ensure they are both right, and keep them 
consistent?<br>
<br></div>Thanks.</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Jan 29, 2014 at 8:40 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On 01/29/2014 10:12 AM, ZhiQiang Fan wrote:<br>
> Hi, Andreas,<br>
><br>
> What does import mean? Is it fixed in specific api project firstly, then<br>
> we sync that content to api-site project, just as what we're doing to<br>
> oslo<->service projects?<br>
<br>
</div>Please continue this on the openstack-docs mailing list. I'm not really<br>
the expert, I just know a bit ;)<br>
<br>
Andreas<br>
<div class="im"><br>
> If it is this situation, could we develope (or it would be really nice<br>
> to already have) utilities to automatically do this to avoid problem<br>
> caused by labor work? If not, which means we just modify two copies, how<br>
> could we ensure they are both right, and keep them consistent?<br>
><br>
> Thanks.<br>
><br>
><br>
> On Wed, Jan 29, 2014 at 3:44 PM, Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a><br>
</div><div><div class="h5">> <mailto:<a href="mailto:aj@suse.com">aj@suse.com</a>>> wrote:<br>
><br>
>     On 01/29/2014 05:52 AM, ZhiQiang Fan wrote:<br>
>     > Hi, OpenStack document team,<br>
><br>
>     The lsit for the documentation team is openstack-docs, not openstack.<br>
>     Let me add them.<br>
><br>
>     > I noticed that there are several repositories in OpenStack named<br>
>     > {service}-api for api document, meanwhile there is a api-site for all<br>
>     > services api document. The problem is that, many content is duplicate,<br>
>     > for example, api-site contains keystone's api description, while<br>
>     > identity-api has mostly same content too (I'm not sure if they are<br>
>     > exactly same). I think it doesn't worth to maintain two project which<br>
>     > have many same content.<br>
>     ><br>
>     > And there are different site for this project, for example, to get<br>
>     > keystone v2 api document, both<br>
>     > <a href="http://docs.openstack.org/api/openstack-identity-service/2.0/content/" target="_blank">http://docs.openstack.org/api/openstack-identity-service/2.0/content/</a><br>
>     > and <a href="http://api.openstack.org/api-ref-identity.html#identity-v2" target="_blank">http://api.openstack.org/api-ref-identity.html#identity-v2</a> can<br>
>     work,<br>
>     > but if there is a bug for document, we need to modify two repositories<br>
>     > which seems unnecessary.<br>
><br>
>     There is already content sharing between them, so while building the<br>
>     api-site, we import documents from the specific api project sites. AFAIK<br>
>     this is still ongoing work.<br>
><br>
>     > So, is there any particular reason why we're in such situation, and is<br>
>     > there any plan to improve it? (maybe one of them can be abandoned?)<br>
><br>
><br>
><br>
>     Andreas<br>
>     --<br>
</div></div>>      Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a> <<a href="http://suse.com" target="_blank">http://suse.com</a>>,<a href="http://opensuse.org" target="_blank">opensuse.org</a><br>

>     <<a href="http://opensuse.org" target="_blank">http://opensuse.org</a>>} Twitter: jaegerandi<br>
<div class="im">>       SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
>        GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
>         GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
><br>
><br>
><br>
><br>
> --<br>
</div>> blog: <a href="http://zqfan.github.com" target="_blank">zqfan.github.com</a> <<a href="http://zqfan.github.com" target="_blank">http://zqfan.github.com</a>><br>
> git: <a href="http://github.com/zqfan" target="_blank">github.com/zqfan</a> <<a href="http://github.com/zqfan" target="_blank">http://github.com/zqfan</a>><br>
<div class="HOEnZb"><div class="h5"><br>
<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><div dir="ltr"><div>blog: <a href="http://zqfan.github.com" target="_blank">zqfan.github.com</a><br></div>git: <a href="http://github.com/zqfan" target="_blank">github.com/zqfan</a><br>
</div>
</div>