<div dir="auto"><div dir="auto"><span style="font-family:sans-serif">-1 to creating our own style. -1 </span><span style="font-family:sans-serif">even to making an override document that links out to variations from an existing style guide. </span></div><div dir="auto"><span style="font-family:sans-serif"><br></span></div><div><span style="font-family:sans-serif">In short the Google style guide is our "standard" and there is a background to this.</span><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif">If down the track we want to introduce the concept of docs linting (validation of docs using tools like Vale) this style guide is compatible with that tool.</div><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif">Another reason is that Google dev guide is also well understood by developers so there will be less onboarding required with this guide than others.</div><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif">If you feel the tips for writing contradict the guidance in the tips for writing we can look further into it.</div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, 3 May 2020, 08:18 Cameron Shorter, <<a href="mailto:cameron.shorter@gmail.com">cameron.shorter@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Moving suggestion from Alyssa onto an email thread, so it doesn't get lost...</div><div><br></div><div><span style="box-sizing:inherit;font-weight:900;word-break:break-word;color:rgb(29,28,29);font-family:Slack-Lato,appleLogo,sans-serif;font-size:15px;font-variant-ligatures:common-ligatures;background-color:rgb(248,248,248)"><a rel="noopener noreferrer noreferrer" href="https://app.slack.com/team/U012KCMPP0V" style="box-sizing:inherit;text-decoration-line:none;display:inline-block" target="_blank">Alyssa</a></span><span style="color:rgb(29,28,29);font-family:Slack-Lato,appleLogo,sans-serif;font-size:15px;font-variant-ligatures:common-ligatures;background-color:rgb(248,248,248)">  </span><a href="https://thegooddocs.slack.com/archives/CQT6T04CW/p1588439680199800" style="box-sizing:inherit;text-decoration-line:none;font-size:12px;font-family:Slack-Lato,appleLogo,sans-serif;font-variant-ligatures:common-ligatures;background-color:rgb(248,248,248)" target="_blank" rel="noreferrer"><span style="box-sizing:inherit">3:14 AM</span></a><br style="box-sizing:inherit;color:rgb(29,28,29);font-family:Slack-Lato,appleLogo,sans-serif;font-size:15px;font-variant-ligatures:common-ligatures;background-color:rgb(248,248,248)"><div style="box-sizing:inherit;max-width:none;margin-bottom:4px;color:rgb(29,28,29);font-family:Slack-Lato,appleLogo,sans-serif;font-size:15px;font-variant-ligatures:common-ligatures;background-color:rgb(248,248,248)"><div style="box-sizing:inherit;max-width:none"><div style="box-sizing:inherit;width:856px"><div style="box-sizing:inherit;display:flex"><div dir="auto" style="box-sizing:inherit;width:856px;line-height:1.46668"><div style="box-sizing:inherit">I've noticed that we currently don't have an official template for a starter style guide (although the <a href="https://github.com/thegooddocsproject/templates/blob/master/writing-tips.md" target="_blank" rel="noreferrer">Writing Tips</a> template does have this kind of content). In my experience, it's sometimes helpful to start out with a bare-bones or boilerplate style guide that your core contributors can just add to here and there as consistency issues arrive. Even if the guide is as simple as "We defer to XYZ's style guide: <link>" + a word list for how to refer to terms that are specific to the project. Would anyone have objections to me perhaps adapting/expanding the Writing Tips template to become a bare bones/boilerplate style guide? No worries if you think this is a bad idea. Feel free to discuss!</div></div></div></div></div></div></div><br clear="all"><div>Hi Alyssa, I like your suggestion and would be happy with you starting on this.</div><div>With regards to the full writing domain, I think that you can separate out document structure from style. And to date I believe we have aimed to focus and get really good at one thing (namely templates and doc structure) rather than be average at lots of things. </div><div>I'd be hesitant to go creating a new style, and suggest that we refer people to existing mature style guides. To date, we have pointed people to Google's developer documentation style guide, <a href="https://developers.google.com/style" target="_blank" rel="noreferrer">https://developers.google.com/style</a>. However, I would anticipate different communities plugging in a separate guide.</div><div>Google also has tech writer training which I think we should lever and align with. Linked from <a href="https://developers.google.com/tech-writing" target="_blank" rel="noreferrer">https://developers.google.com/tech-writing</a></div><div>I'd be interested to hear your thoughts on this approach?</div><div>I'd also be interested to hear Jared's thoughts on whether the writing tips he wrote should be extended, or whether it should be approached separately.</div><div><br></div><div>Cheers,</div>-- <br><div dir="ltr" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><div><span style="font-size:12.8px">Cameron Shorter</span><br></div><div>Technology Writer at Google</div><div><br></div><div>M +61 (0) 419 142 254</div><div><br></div></div><div><br><br></div></div></div></div></div></div></div></div></div></div></div></div>
</blockquote></div></div></div>