<div dir="ltr"><div class="gmail_quote"><div dir="ltr"><div class="gmail_quote"><div dir="ltr"><div class="gmail_quote"><div dir="ltr"><div class="gmail_quote"><div dir="ltr"><div class="gmail_quote"><div dir="ltr">Hi</div><div dir="ltr"><br></div><div dir="ltr">Tomorrow's TeX Hour continues from last month's topic: Better Technical Documentation.</div><div dir="ltr"><br></div><div dir="ltr">Date and time: Thursday 17 March, 6:30 to 7:30pm UK (and UTC) time.<br>UK time now: <a href="https://time.is/UK" target="_blank">https://time.is/UK</a>.<br>Zoom URL: <a href="https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09" target="_blank">https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09</a><br></div><div dir="ltr"><br></div><div dir="ltr">Last month's meeting was based on a "needs discovery" meeting organised by Daniele Procida, who I've met several times at UK Python conferences. Daniele is now one of several Directors of Engineering at Canonical, the  developers of Ubuntu Linux, where he has special responsibility for improving both documentation and the process by which it is created.</div><div dir="ltr"><br></div><div>Daniele is now giving 3 weekly 2 hour workshops to research software engineers. Tomorrow's TeX Hour is based on my experience of the first two workshops. Here's my core of last week's workshop.</div><div><br></div><div>People have different modes of activity. Common modes are sitting, standing and lying. Listening, talking and observing. Common modes related to tools are handling a tool, using a tool, creating a tool and understanding a tool. Software documentation works better when it fits the mode of activity. To be useful, this knowledge must be incorporated into experience and practice.</div><div><br></div><div>The third and final workshop next week will be on tooling, with a focus on the Sphinx system, which was created especially for the core Python documentation. It's been in use since 2008. The previous system used LaTeX as the input syntax. Sphinx uses the specially developed RST markup language.</div><div><a href="https://www.sphinx-doc.org/en/master/" target="_blank">https://www.sphinx-doc.org/en/master/</a><br></div><div><br></div><div>Last month's TeX Hour on Better Technical Documentation <a href="https://youtu.be/gbBNuUOWF0c" target="_blank">https://youtu.be/gbBNuUOWF0c</a></div><div>Last week's TeX Hour on CLI and text interfaces, Python syntax errors <a href="https://youtu.be/E6jXQMRvVcg" target="_blank">https://youtu.be/E6jXQMRvVcg</a><br></div><div><br></div><div>This week's TeX Hour is: Thursday 17 March, 6:30 to 7:30pm UK (and UTC) time.</div><div>UK time now: <a href="https://time.is/UK" target="_blank">https://time.is/UK</a>.<br>Zoom URL: <a href="https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09" target="_blank">https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09</a><br></div><div><br></div><div dir="ltr"><div>with best regards</div><div><br></div><div>Jonathan</div></div>
</div></div>
</div></div>
</div></div>
</div></div>
</div></div>