<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Apr 14, 2015 at 5:27 AM, 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 04/14/2015 12:12 PM, Christian Berendt wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
The document change history table<br>
(<a href="http://docs.openstack.org/juno/install-guide/install/yum/content/ch_preface.html" target="_blank">http://docs.openstack.org/<u></u>juno/install-guide/install/<u></u>yum/content/ch_preface.html</a>)<br>
does not makes sense to me because the change history is incomplete<br>
(e.g. no "start documentation for kilo").<br>
</blockquote>
<br></span>
We update in general at least once per release. Patches are welcome ;)<span class=""><br>
<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
I would prefer to remove the document change history table and to<br>
replace it with a list of links to available specifications (e.g.<br>
<a href="http://specs.openstack.org/openstack/docs-specs/specs/kilo/installguide-kilo.html" target="_blank">http://specs.openstack.org/<u></u>openstack/docs-specs/specs/<u></u>kilo/installguide-kilo.html</a>).<br>
</blockquote>
<br></span>
I suggest to add the basics from the spec to the history to see what was actually done - or add what we plan and we revise later ;)</blockquote><div><br></div><div>Those document change histories aren't useful, I'd support removal. They're definitely not coming over when we migrate to RST.</div><div><br></div><div>I think the git history is the best place for understanding what changed when.</div><div><br></div><div>Not sure how to integrate a link to the spec though, maybe that is done with commit messages that point to the blueprint? Sure it's a few clicks removed, but I think the best traipse through history we should offer.</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"><span class="HOEnZb"><font color="#888888"><br>
<br>
Andreas<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/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
       Graham Norton, HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126</font></span><div class="HOEnZb"><div class="h5"><br>
<br>
<br>
______________________________<u></u>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>