Re: [OSGeoLive] Quick starts template question (Season of Docs)

2019-10-14 Thread Cameron Shorter
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): 1. The exemplar project is likely to change,

Re: [OSGeoLive] Quick starts template question (Season of Docs)

2019-10-14 Thread Felicity Brand
In the OSGeoLive-doc\doc\quickstart directory, there's a file called `toc.rst` that has the following contents: -- .. only:: latex .. toctree:: :maxdepth: 1 :glob: *_quickstart - I can't read the code but didn't want to plonk a

Re: [OSGeoLive] Quick starts template question (Season of Docs)

2019-10-14 Thread Cameron Shorter
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. Re creating a new template.rst: The template.rst will

Re: [OSGeoLive] Quick starts template question (Season of Docs)

2019-10-14 Thread Felicity Brand
I have raised a PR today for the changes I made to the writing tips in the uDig Quick Start file. Jody and Frank, I made a few minor changes to the uDig content as a result. Here is a link to the pull request in GitHub: https://github.com/OSGeo/OSGeoLive-doc/pull/512 I would appreciate some eyes

Re: [OSGeoLive] Quick starts template question (Season of Docs)

2019-10-14 Thread Felicity Brand
I checked the history of the toc file but it was inconclusive :-) Looks like it's been there a while. Vicky Vergara might have a recollection about it. I see what you're saying: It is unlikely someone would stumble upon the URL unless they guessed the name of the file and manually typed it in to t

[OSGeoLive] Quick Starts template documenting wiki/trac (Season of Docs)

2019-10-14 Thread Felicity Brand
Hi all, me again. The wiki has this page that includes information about documentation for OSGeo Live: https://wiki.osgeo.org/wiki/OSGeoLive_AddProject#Documentation As I understand it, your wiki moved to "trac". I found this page: https://trac.osgeo.org/osgeolive/wiki/How%20to%20document%20a%20