<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, May 28, 2018 at 11:46 AM, Stefano Canepa <span dir="ltr"><<a href="mailto:sc@linux.it" target="_blank">sc@linux.it</a>></span> wrote:<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span class=""><div><br></div></span><div style="font-family:monospace,monospace">Petr,<br>​do we really need to reference to another style guide? <br>How many times people clicked on the link to the IBM guide?​</div><div style="font-family:monospace,monospace"><br></div></div></div></div></blockquote><div>Many years ago, I tried to understand the rationale behind some of the doc team's recommendations. All roads led to this secret IBM guide. I did not know of any easy way to get access to it, gave up, and stuck my head back in the sand.</div><div><br></div><div>Having said that, I figured if that was the best way for the docs team to do their work, who was I to argue about it, since I wasn't going to ante up and do any of that work myself. *Some* documentation is better than *no* documentation :)</div><div><br></div><div>How much of that IBM guide is used? Would it be easier to just summarize the parts of interest? I've managed to live w/o looking at it (which doesn't say much I guess). I dread another massive change to documentation across all projects, due to changes of style. Unless it is all automated, I don't feel like it is the best use of our human resources at this point in time. (If you want to use your pets for this, I'm all for it.)</div><div><br></div><div>--ruby </div></div><br></div></div>