TeX Hour tonight: Better Technical Documentation: 18:30 UTC time

--===============5952834130916576977==
Content-Type: multipart/alternative; boundary="00000000000050a9b005d8c4c125"

--00000000000050a9b005d8c4c125
Content-Type: text/plain; charset="UTF-8"

Hi

Tonight's TeX hour is from 6:30 to 7:30pm UK (and UTC) time. The UK time
now: https://time.is/UK.
The zoom URL is
https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09

Last week I attended 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.

Daniele is also a current Fellow of the Software Sustainability Institute.
The meeting last week was to discover needs for a workshop he's holding
next month, to help Research Software Engineers improve their
documentation. There were over 20 people there.

I hope that at tonight's TeX Hour we will share our experience of writing,
rendering and using technical documentation, particularly  for software.
Daniele's approach is focussed on a quadrant of user needs.

The quadrant is

Top left: Tutorials (focussed on learning).
Top right: How-to guides (focussed on tasks).
Bottom left:  Explanation (focussed on understanding).
Bottom right: Reference (focussed on information).

The up-down axis is practice and theory. The left-right axis is study and
work.

Interested? Reflect on your own documentation experience, and visit:

https://www.software.ac.uk/about/fellows/daniele-procida
https://diataxis.fr/
https://mail.python.org/pipermail/python-uk/2022-February/004828.html

Tonight's TeX hour is from 6:30 to 7:30pm UK (and UTC) time. The UK time
now: https://time.is/UK.
The zoom URL is
https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09

wishing you beautiful and effective documents

Jonathan

--00000000000050a9b005d8c4c125
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div class=3D"gmail_quote"><div dir=3D"ltr">Hi<div><br></d=
iv><div><div>Tonight&#39;s TeX hour is from 6:30 to 7:30pm UK (and UTC) tim=
e. The UK time now: <a href=3D"https://time.is/UK" target=3D"_blank">https:=
//time.is/UK</a>.</div><div>The zoom URL is <a href=3D"https://us02web.zoom=
.us/j/78551255396?pwd=3DcHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09" target=3D"_blank"=
>https://us02web.zoom.us/j/78551255396?pwd=3DcHdJN0pTTXRlRCtSd1lCTHpuWmNIUT=
09</a></div><div><div><br></div><div>Last week I attended a &quot;needs dis=
covery&quot; meeting organised by Daniele Procida, who I&#39;ve met several=
 times at UK Python conferences. Daniele is now one of several Directors of=
 Engineering at Canonical, the=C2=A0 developers of Ubuntu Linux, where he h=
as special responsibility for improving both documentation and the process =
by which it is created.</div><div><br></div><div>Daniele is also a current =
Fellow of the Software Sustainability Institute. The meeting last week was =
to discover needs for a workshop he&#39;s holding next month, to help Resea=
rch Software Engineers improve their documentation. There were over 20 peop=
le there.</div><div><br></div><div>I hope that at tonight&#39;s TeX Hour we=
 will share our experience of writing, rendering and using technical docume=
ntation, particularly=C2=A0 for software. Daniele&#39;s approach is focusse=
d on a quadrant of user needs.=C2=A0</div><div><br></div><div>The quadrant =
is</div><div><br></div><div>Top left: Tutorials (focussed on learning).=C2=
=A0</div><div>Top right: How-to guides (focussed on tasks).</div><div>Botto=
m left:=C2=A0 Explanation (focussed on understanding).</div><div>Bottom rig=
ht: Reference (focussed on information).</div><div><br></div><div>The up-do=
wn axis is practice and theory. The left-right axis is study and work.=C2=
=A0</div><div><br></div><div>Interested? Reflect on your own documentation =
experience, and visit:</div><div><br></div><div><a href=3D"https://www.soft=
ware.ac.uk/about/fellows/daniele-procida" target=3D"_blank">https://www.sof=
tware.ac.uk/about/fellows/daniele-procida</a><br></div><div><a href=3D"http=
s://diataxis.fr/" target=3D"_blank">https://diataxis.fr/</a><br></div><div>=
<a href=3D"https://mail.python.org/pipermail/python-uk/2022-February/004828=
.html" target=3D"_blank">https://mail.python.org/pipermail/python-uk/2022-F=
ebruary/004828.html</a></div><div><br></div><div><div>Tonight&#39;s TeX hou=
r is from 6:30 to 7:30pm UK (and UTC) time. The UK time now: <a href=3D"htt=
ps://time.is/UK" target=3D"_blank">https://time.is/UK</a>.</div><div>The zo=
om URL is <a href=3D"https://us02web.zoom.us/j/78551255396?pwd=3DcHdJN0pTTX=
RlRCtSd1lCTHpuWmNIUT09" target=3D"_blank">https://us02web.zoom.us/j/7855125=
5396?pwd=3DcHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09</a></div></div><div><br></div><=
div>wishing you beautiful and effective documents</div><div><br></div><div>=
Jonathan</div><div><br></div><div><br></div></div></div></div>
</div></div>

--00000000000050a9b005d8c4c125--

--===============5952834130916576977==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
python-uk mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-uk

--===============5952834130916576977==--