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

Felicity Brand felicitybrand at gmail.com
Mon Oct 14 21:17:03 PDT 2019


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 on it.

Then I can move forward with my proof of concept of applying this to
the trial Quick Starts to get my workflow set up.

Thank you
Felicity

On Mon, Oct 14, 2019 at 9:11 PM Cameron Shorter
<cameron.shorter at gmail.com> wrote:
>
> 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, and need updating, and might not be exemplar any more.
> 2. There is potential other projects get jealous about not being selected as an exemplar project.
> 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).
>
> On Mon, 14 Oct 2019 at 11:06, Felicity Brand <felicitybrand at gmail.com> wrote:
>>
>> Hi all,
>> I realized that before I do my dry run-though, I need to submit a PR
>> with my changes to the Quick Start template. My changes are in the
>> "Writing tips" sections.
>>
>> At the moment, these writing tips are embedded in the
>> uDig_quickstart.rst
>> https://github.com/flicstar/OSGeoLive-doc/blob/master/doc/quickstart/udig_quickstart.rst
>>
>> Is this where we want to keep them? I wonder if a new file called
>> "template_quickstart.rst" would be better?
>>
>> Please advise.
>> Thanks
>> Felicity
>> _______________________________________________
>> osgeolive mailing list
>> osgeolive at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/osgeolive
>
>
>
> --
> Cameron Shorter
> Technology Demystifier
> Open Technologies and Geospatial Consultant
>
> M +61 (0) 419 142 254
>
>
>


More information about the osgeolive mailing list