<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"Calibri Light";
panose-1:2 15 3 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p.msonormal0, li.msonormal0, div.msonormal0
{mso-style-name:msonormal;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Dear All,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Just to chip in our interesting from a City Futures Research Centre, UNSW Sydney perspective.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">We are currently developing a Disruptive Technologies in Cities educational module which uses Citydata (Geonode)
<a href="https://citydata.be.unsw.edu.au">https://citydata.be.unsw.edu.au</a> for sourcing Airbnb data, then inputs this into QGIS for some City Analytics to understand spatial patterns of Airbnb usage across different cities and within existing cities
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">If it aligns where this SeasonofDocs initiative is going we would to be happy to contribute this via tutorial, and videos.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">A couple of related publications:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Pettit, C.J. Ticzon,C . Reades, J. Wentz, E.. Ong, P. Martin, C. Troy, L. Crommelin, L. (2018) How Disruptive Technology is Impacting the Housing and Property Markets in Real Estate and GIS The Application of Mapping Technologies, (Reed,
R, Pettit, C, eds) Routledge, pp36-64.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Crommelin, L., Troy, L. Martin, C. Pettit, C. (2018). "Is Airbnb a sharing economy superstar? Evidence from five global cities." Urban Policy and Research: 1-16.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Any thoughts, interest?<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Regards<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Chris<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" style="margin-left:9.1pt;background:white;border-collapse:collapse">
<tbody>
<tr style="page-break-inside:avoid">
<td width="200" style="width:150.2pt;padding:0in 5.4pt 0in 5.4pt">
<p class="MsoNormal" style="mso-margin-top-alt:0in;margin-right:4.75pt;margin-bottom:0in;margin-left:1.7pt;margin-bottom:.0001pt">
<span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU"><img border="0" width="179" height="134" style="width:1.8645in;height:1.3958in" id="Picture_x0020_1" src="cid:image001.png@01D51585.20EC2C00" alt="Title: City Futures - Description: City Futures Logo"></span><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
</td>
<td width="408" valign="top" style="width:306.2pt;padding:0in 5.4pt 0in 5.4pt">
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><b><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">Chris Pettit
</span></b><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><b><i><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">Professor of Urban Science</span></i></b><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><i><span style="font-size:9.0pt;font-family:"Calibri Light",sans-serif;color:black;mso-fareast-language:EN-AU">Director – City Analytics Program<o:p></o:p></span></i></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><i><span style="font-size:9.0pt;font-family:"Calibri Light",sans-serif;color:black;mso-fareast-language:EN-AU">Associate Director, City Futures Research Centre</span></i><span style="font-family:"Calibri Light",sans-serif;mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><i><span style="font-size:10.0pt;font-family:"Calibri Light",sans-serif;color:black;mso-fareast-language:EN-AU">PLuS Alliance Fellow</span></i><span style="font-family:"Calibri Light",sans-serif;mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><i><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU"> </span></i><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">Built Environment, UNSW Sydney</span><span style="font-size:10.0pt;color:black;mso-fareast-language:EN-AU"><br>
</span><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">UNSW SYDNEY NSW 2052 AUSTRALIA
</span><span style="font-size:10.0pt;color:black;mso-fareast-language:EN-AU"><br>
</span><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">T: +61 (2) 9385 4826</span><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">M: +61 422 301 832</span><span style="font-size:10.0pt;color:black;mso-fareast-language:EN-AU"><br>
</span><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">E: </span>
<a href="mailto:c.pettit@unsw.edu.au"><span style="font-size:9.0pt;color:#0563C1;mso-fareast-language:EN-AU">c.pettit@unsw.edu.au</span></a><u><span style="font-size:9.0pt;color:blue;mso-fareast-language:EN-AU">
</span></u><span style="font-size:10.0pt;color:black;mso-fareast-language:EN-AU"><br>
</span><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">W: </span>
<a href="http://www.cityfutures.net.au/"><span style="font-size:9.0pt;mso-fareast-language:EN-AU">cityfutures.net.au</span></a><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">W:</span><span style="mso-fareast-language:EN-AU">
</span><a href="http://www.be.unsw.edu.au/postgraduate-degrees/city-analytics/about"><span style="font-size:9.0pt;color:#0563C1;mso-fareast-language:EN-AU">http://www.be.unsw.edu.au/postgraduate-degrees/city-analytics/about</span></a><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU">
</span><u><span style="font-size:9.0pt;color:blue;mso-fareast-language:EN-AU"> </span></u><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:1.7pt;text-autospace:none"><span style="font-size:9.0pt;color:black;mso-fareast-language:EN-AU"> </span><span style="mso-fareast-language:EN-AU"><o:p></o:p></span></p>
</td>
</tr>
</tbody>
</table>
<p class="MsoNormal"><span style="color:#1F497D;mso-fareast-language:EN-AU"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span style="color:#1F497D;mso-fareast-language:EN-AU">Latest Publications
<o:p></o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#1F497D;mso-fareast-language:EN-AU"><o:p> </o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#1F497D;mso-fareast-language:EN-AU"><o:p> </o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#1F497D;mso-fareast-language:EN-AU">Journals</span></b><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="color:#4472C4">Pettit, C. Hawken, S, Ticzon, C Steinitz, C, Ballal H. T. Cranfield. Leao, S. Afrooz, A, Lieske, S. (2019) Breaking down the silos through geodesign – Envisioning Sydney’s urban future, Environment and Planning
B: Urban Analytics and City Science.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Lu, Y., Laffan, S., Pettit, C., & Cao, M. (2019). Land use change simulation and analysis using a vector cellular automata (CA) model: A case study of Ipswich City, Queensland, Australia. Environment and Planning
B: Urban Analytics and City Science. https://doi.org/10.1177/2399808319830971<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Pettit, C., Bakelmun, A., Lieske, S.N., Glackin, S., Thomson, G., Shearer, H., Dia, H. and Newman, P., (2018). Planning support systems for smart cities. City, Culture and Society., pp 13-24.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Taylor, A. & Pettit, C. (2018) Are Health Services in New South Wales Available Where They are Needed? Using AURIN to Understand the Equity of Service Distribution and Future Demand, Applied Spatial Analysis
and Policy, pp1-25.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Crommelin, L., Troy, L. Martin, C. Pettit, C. (2018). "Is Airbnb a sharing economy superstar? Evidence from five global cities." Urban Policy and Research: 1-16.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span style="color:#4472C4">Books<o:p></o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#4472C4"><o:p> </o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#4472C4"><o:p> </o:p></span></b></p>
<p class="MsoNormal"><span style="color:#4472C4">Geertman, S., Zhan, Q, Allan, A., Pettit, C.J (2019) Computational Urban Planning and Management for Smart Cities, Springer International Publishing.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Pettit, C., Crommelin, L., Sharam, A. and Hulse, K., (2018). The potential of new technologies to disrupt housing policy, AHURI, Melbourne.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Pettit, C., Liu, E., Rennie, E., Goldenfein, J. and Glackin, S., (2018). Understanding the disruptive technology ecosystem in Australian urban and housing contexts: a roadmap, AHURI, Melbourne.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Reed, R. and C. Pettit (2018). Real Estate and GIS: The Application of Mapping Technologies, Routledge.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span style="color:#4472C4">Book Chapters<o:p></o:p></span></b></p>
<p class="MsoNormal"><b><span style="color:#4472C4"><o:p> </o:p></span></b></p>
<p class="MsoNormal"><span style="color:#4472C4">Pettit, C. Hawken, S, Nakanishi, H. (2019) Geodesign - A Tale of 3 Cities, In Computational Urban Planning and Management for Smart Cities. Springer International Publishing.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4">Afrooz, A.E. Ding, L., Pettit, C. (2019). An immersive 3D virtual environment to support collaborative learning and teaching, In Computational Urban Planning and Management for Smart Cities. Springer International
Publishing.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#4472C4"><o:p> </o:p></span></p>
<p class="MsoNormal"> <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"> <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b>From:</b> SeasonOfDocs <seasonofdocs-bounces@lists.osgeo.org>
<b>On Behalf Of </b>Jo Cook<br>
<b>Sent:</b> Tuesday, May 28, 2019 4:12 AM<br>
<b>To:</b> seasonofdocs@lists.osgeo.org<br>
<b>Subject:</b> [SeasonOfDocs] Best practice links<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">Hi All,<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">I've been adding a few links on good practice when writing documentation to our ideas page at <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>.
This includes things like "words to avoid", particularly when writing documentation aimed at new users. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">For example something that has bugged me for years, but is summed up really well in one of the links, is using words like "just..." and "simply..." particularly when followed by an instruction to install something with npm or pip, or create
a virtual environment. These things are all straightforward when you're familiar with the tools, but as a new user you may need to go through several steps first to get set up with npm/pip/virtual environments, and it's extremely discouraging if you feel that
you can't event get to stage one.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">It would be good to hear from everyone about other phrases or words that we should avoid using, and it would be even better, when we get a few more links, to try to distil the suggestions into something that could be added to a best practice
document, almost like a checklist.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">All the best<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Jo<br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">-- <o:p></o:p></p>
<div>
<p class="MsoNormal">------------------------<br>
<a href="http://about.me/jocook" target="_blank">http://about.me/jocook</a><o:p></o:p></p>
</div>
</div>
</div>
</div>
</body>
</html>