<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>I'm summarising a few conversations I've joined in the last few
days, and a couple more coming re creating a Writing Templates /
Guides project.</p>
<p>For those being looped into this conversation for the first time,
here are some getting started links:</p>
<p>--<br>
</p>
<p>Stephanie Blotner is a tech writer at Uber and did a great
podcast <a class="moz-txt-link-freetext" href="https://www.youtube.com/watch?v=1ZmAEuC2zuA">https://www.youtube.com/watch?v=1ZmAEuC2zuA</a> about
empowering developers to become better writers .. and quite a bit
more. She covers some of this in this blog post:
<a class="moz-txt-link-freetext" href="https://increment.com/documentation/primer-on-documentation-content-strategy/">https://increment.com/documentation/primer-on-documentation-content-strategy/</a>
. She has also suggested <a
href="https://github.com/San-Francisco-Write-The-Docs/lone-writers-guide">https://github.com/San-Francisco-Write-The-Docs/lone-writers-guide</a>
as a group who have started collating tech writer know-how.<br>
</p>
<p>Stephanie, you were wondering about IP and getting permission to
share company writing guides. The bottom line is that in the
digital economy, <b>collaboration out competes competition</b>.
Longer version at: <a
href="http://cameronshorter.blogspot.com/2018/10/the-open-business-business-case.html">http://cameronshorter.blogspot.com/2018/10/the-open-business-business-case.html</a></p>
--
<p>Sara Ratner is an educational specialist covered a bunch of
ideas. A highlight for me was:</p>
<p>* In high schools we teach kids recounts, poetry, ... but not
technical writing, which is an important skill for our next
generation workforce. If we can define tech writing course
material, then we can then teach it.</p>
<p>--</p>
<p>Sarah Maddox, spiritual leader of SeasonOfDocs, pointed to
material we can build from:</p>
<p>Open-sourced pre-work for Google's Tech Writing 101 class.
<a class="moz-txt-link-freetext" href="https://lisafc.github.io/tw101-reading/">https://lisafc.github.io/tw101-reading/</a><br>
The source is on GitHub: <a class="moz-txt-link-freetext" href="https://github.com/LisaFC/tw101-reading">https://github.com/LisaFC/tw101-reading</a><br>
<br>
"Various README templates & tips on writing high-quality
documentation that people want to read."
<a class="moz-txt-link-freetext" href="https://github.com/kylelobo/The-Documentation-Compendium">https://github.com/kylelobo/The-Documentation-Compendium</a><br>
</p>
<p>--</p>
<p>And for those who are not up to speed yet:</p>
<p>* The SeasonOfDocs template writing ideas we've started is here:<a
href="https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates">
https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates</a></p>
<p>* You can join our email list discussion by subscribing here: <a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
. (Email archives are also linked from this page)</p>
<p>* My long-hand story and inspiration for building writing
templates and guides is at <a
href="http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html">http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html</a></p>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>