Re: [OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-11 Thread Cameron Shorter
Hi Felicity, comments inline: On 11/10/19 3:01 pm, Felicity Brand wrote: Hello all, I am about to do my proof of concept trial with 2 Quick Starts. I thought I'd choose MapSlicer and Mapbender because both Astrid and Angelos expressed an interest in improving the Quickstarts for their projects

Re: [OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-10 Thread Felicity Brand
Hello all, I am about to do my proof of concept trial with 2 Quick Starts. I thought I'd choose MapSlicer and Mapbender because both Astrid and Angelos expressed an interest in improving the Quickstarts for their projects :-) This should give me good practice to see if the GitHub process works ou

Re: [OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-07 Thread Seth G
Hi Felicity, With regards to the Sphinx markup, using the directives would have the following advantages: - allow a consistent way to show menu selections (or any conventions such as File > Open, File -> Open, File | Open could be used. It is probably simplest to stay with the Sphinx conventio

Re: [OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-07 Thread Cameron Shorter
Hi Felicity, Re labels, I don't feel strongly about whether we use them or not, but whatever we do, we aim to be consistent, and document our decision in our Quickstart template. I'd probably err on: 1. Adopting whatever is commonly used by all projects. 2. Keeping our use of labels simple (

Re: [OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-07 Thread Nicolas Roelandt
Hi Felicity, Thanks for working on this and asking things ! For the Sphinx markup, I don't have a good response. I did like it was made as it is part of the process. But this can be questioned ! For your comments, if you don't want to change code and make a PR, fill an issue in Trac so we can co

[OSGeoLive] Quick starts status update (Google Season of Docs)

2019-10-06 Thread Felicity Brand
Hello all, I've been working on the Quick Start template and there are a couple of questions I wanted to ask. I have come across the Sphinx markup :guilabel: and :menuselection: What do we gain by using these? It seems to me something extra to type. I understand we can then render them a particul