<div dir="ltr">Outside of the installation guide, we should avoid using any commands specific to distributions or packages because our audience may incorrectly assume the documentation limits how and where they can deploy OpenStack. Similarly, we should avoid spelling out general OS commands (such as making symlinks and showing network interfaces) because our audience should already understand how to use the OS before deploying OpenStack.</div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 20, 2015 at 10:24 PM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.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="">Le 2015-07-20 14:44, Christian Berendt a écrit :<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 07/19/2015 06:26 PM, Tom Fifield wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On the other hand, I agree that it is a fair assumption that our readers<br>
understand how to do a service restart - this is a fairly basic and<br>
essential sysadmin practice.<br>
</blockquote>
<br>
+1<br>
<br>
Maybe we should add a list of required and assumed previous knowledge.<br>
</blockquote>
<br></span>
I can start this list but for now service restart is the only obvious element I can think of. Maybe we could just leave it at that and simply add a "don't write CLI samples for service restarts, except in the install guide" to the conventions.<br>
<br>
How does it sound?<br>
<br>
Thanks,<br>
Gauvain<div class="HOEnZb"><div class="h5"><br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">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></div>