<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sat, May 7, 2016 at 1:51 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"><span class="">On 05/07/2016 06:09 PM, Ildikó Váncsa wrote:<br>
> Hi Matt,<br>
><br>
> I'm open to discuss what would be the best way forward in this topic. First of all I would like to understand the intention with document structures long term to see how we can have a scalable and maintainable process.<br>
><br>
> My experience is that keeping the documentation up to date separately from the code can be difficult that results in outdated materials, which also leads to bad user experience and impression.<br>
><br>
> Would this topic be sufficient for one of the team meetings?<br>
<br>
</span>Right now we have the Install Guide as first guide where we move content<br>
to the teams and still want to provide this from one place.<br>
<br>
I suggest that we do the Install Guide first and then consider whether<br>
that is a model that we should use for other documents as well,<br></blockquote><div><br></div><div>Another example model to keep an eye on is the current move of content from api-site to project repos. Let's see how that goes as well -- quality/accuracy, usefulness, and ongoing maintenance as first goals. </div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Andreas<br>
<span class="HOEnZb"><font color="#888888">--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>