<div dir="ltr">I'm not sure what the toc.rst file is doing in the directory. I suspect it probably should be removed, or maybe it is being pulled in by a template. If you check the version history you should be able to find out who created it, then ask them.<div><br></div><div>Re creating a new template.rst: The template.rst will not be findable from other docs if no one links to it. However, I'm pretty sure the html page is created and accessible from say <a href="https://live.osgeo.org/en/quickstart/template_quickstart.html">https://live.osgeo.org/en/quickstart/template_quickstart.html</a> . That is ok. (We have previously allowed emerging projects to create their Project Overview on OSGeoLive, but not linked into the main docs as a stepping stone to getting included into OSGeoLive.)</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, 15 Oct 2019 at 14:35, Felicity Brand <<a href="mailto:felicitybrand@gmail.com">felicitybrand@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">In the OSGeoLive-doc\doc\quickstart directory, there's a file called<br>
`toc.rst` that has the following contents:<br>
--------------------------<br>
.. only:: latex<br>
   .. toctree::<br>
     :maxdepth: 1<br>
     :glob:<br>
     *_quickstart<br>
-----------------------------<br>
<br>
I can't read the code but didn't want to plonk a new file called<br>
"template.rst" into the directory in case this code is generating an<br>
automatic list of quickstarts that displays somewhere important.<br>
Would this be why you embedded writing instructions into a quickstart<br>
in the first place, rather than having it in its own file?<br>
<br>
On Mon, Oct 14, 2019 at 9:11 PM Cameron Shorter<br>
<<a href="mailto:cameron.shorter@gmail.com" target="_blank">cameron.shorter@gmail.com</a>> wrote:<br>
><br>
> While it would be ok to put into the udig_quistart.rst, I agree that it would be better to have a template_quickstart.rst. Erin, a Google tech writer recently made the comment that there are downsides with selecting an exemplar project (as we have done):<br>
> 1. The exemplar project is likely to change, and need updating, and might not be exemplar any more.<br>
> 2. There is potential other projects get jealous about not being selected as an exemplar project.<br>
> An alternative she suggested is to create a simple imaginary project (maybe about mapping time-travel through worm holes in space, or something equally silly).<br>
><br>
> On Mon, 14 Oct 2019 at 11:06, Felicity Brand <<a href="mailto:felicitybrand@gmail.com" target="_blank">felicitybrand@gmail.com</a>> wrote:<br>
>><br>
>> Hi all,<br>
>> I realized that before I do my dry run-though, I need to submit a PR<br>
>> with my changes to the Quick Start template. My changes are in the<br>
>> "Writing tips" sections.<br>
>><br>
>> At the moment, these writing tips are embedded in the<br>
>> uDig_quickstart.rst<br>
>> <a href="https://github.com/flicstar/OSGeoLive-doc/blob/master/doc/quickstart/udig_quickstart.rst" rel="noreferrer" target="_blank">https://github.com/flicstar/OSGeoLive-doc/blob/master/doc/quickstart/udig_quickstart.rst</a><br>
>><br>
>> Is this where we want to keep them? I wonder if a new file called<br>
>> "template_quickstart.rst" would be better?<br>
>><br>
>> Please advise.<br>
>> Thanks<br>
>> Felicity<br>
>> _______________________________________________<br>
>> osgeolive mailing list<br>
>> <a href="mailto:osgeolive@lists.osgeo.org" target="_blank">osgeolive@lists.osgeo.org</a><br>
>> <a href="https://lists.osgeo.org/mailman/listinfo/osgeolive" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/osgeolive</a><br>
><br>
><br>
><br>
> --<br>
> Cameron Shorter<br>
> Technology Demystifier<br>
> Open Technologies and Geospatial Consultant<br>
><br>
> M +61 (0) 419 142 254<br>
><br>
><br>
><br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><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 Demystifier</div><div>Open Technologies and Geospatial Consultant</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>