Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Using LearnOSM material to compile new OSM documentation for OSGeo-Live #524

Closed
kalxas opened this Issue Jun 8, 2017 · 11 comments

Comments

Projects
None yet
5 participants
@kalxas
Copy link

kalxas commented Jun 8, 2017

Hi all,

The OSGeo-Live team (https://live.osgeo.org/) is looking for new documentation for OSM (current OSM overview https://live.osgeo.org/en/overview/osm_overview.html and current quickstart tutorial https://live.osgeo.org/en/quickstart/osm_quickstart.html) and we are wondering if there is any volunteer from your project to help us compile a new quickstart document.

We think that the following 2 documents could be adapted for our use case:
https://github.com/hotosm/learnosm/blob/gh-pages/_posts/en/1900-12-21-start-josm.md
https://github.com/hotosm/learnosm/blob/gh-pages/_posts/en/0200-12-23-id-editor.md

Best regards,
Angelos
OSGeo-Live PSC chair

@althio

This comment has been minimized.

Copy link
Contributor

althio commented Jun 9, 2017

Hi @kalxas

Glad to see you here and happy that you have interest in the content for OSGeo-Live.

If I understand correctly from other discussions about OSGeo-Live, your deadline is 3 July for this quickstart document, correct?

I would like to help you there :)
Any takers in the LearnOSM team for more English writing/proofreading?

@kalxas

This comment has been minimized.

Copy link
Author

kalxas commented Jun 9, 2017

Hi @althio
Thank you for your response.
Correct, our deadline for the documentation updates is 3rd of July.
So far the volunteers for this task is you and me, I hope more volunteers can join us soon :)
Any ideas where to reach out asking for more volunteers?

@Nick-Tallguy

This comment has been minimized.

Copy link
Contributor

Nick-Tallguy commented Jun 9, 2017

I'd like to help on this but don't think I will have time. I'll try to monitor and join in if I can.

@kalxas

This comment has been minimized.

Copy link
Author

kalxas commented Jun 10, 2017

Thanks @Nick-Tallguy

@LibertatisPrius

This comment has been minimized.

Copy link

LibertatisPrius commented Jun 12, 2017

I will probably be able to help but I I've never done anything like this before. I'm primarily familiar with iD but I have some experience with JOSM.

(Just FYI, I learned about this through the Osmf-talk mailing list.)

@kalxas

This comment has been minimized.

Copy link
Author

kalxas commented Jun 13, 2017

Thanks @LibertatisPrius
We will need your help.

@camerons

This comment has been minimized.

Copy link

camerons commented Jun 24, 2017

Hi @kalxas, @althio, @Nick-Tallguy, @LibertatisPrius, @mikelmaron,
Thanks for offering to help.
I'm one of the core members of the OSGeo-Live project, and happy to help mentor people writing documentation for the project.

Our guidelines for writing OSGeo-Live documentation are linked from here:
https://wiki.osgeo.org/wiki/Live_GIS_Disc#Documentation , but to fast track things, our minimum need to get started would be to copy the existing text and images to RST format from:

Put the text into:

Put images as png into: https://github.com/hotosm/learnosm/blob/gh-pages/_posts/en/1900-12-21-start-josm.md

There may be some places where it would help to adjust text to align with OSGeo-Live. Eg: The applications are pre-installed on a VM or USB that people are running, typically in a classroom setting, so we don't need to tell people how to install.

This would be the minimum needed to get up and running.

If we want to improve quality and consistency, we can then improve the text to align with our writing standards. The UDig quickstart is our template project we use which contains writing tips:

Thanks for offering to help, Cameron

@camerons

This comment has been minimized.

Copy link

camerons commented Jul 5, 2017

With help from @cvvergara, I've taken these ideditor and jsom docs and moved into OSGeo-Live Quickstart docs.
Pull request here: OSGeo/OSGeoLive-doc#254
I've hopefully included the history in the process.
It should linked in from our cutting edge docs within 24 hours here: http://adhoc.osgeo.osuosl.org/livedvd/docs/en/overview/overview.html
It would be good if someone could review and make sure they look ok. (If you review, please let us know you have so we know it has been checked).
Also, we will be wanting to check these docs are up to date when we release every year.
@althio, @Nick-Tallguy, @LibertatisPrius, @mikelmaron, I wonder if you'd mind if we asked if you could be a point of contact for this? If so, could you please email me (cameron . shorter AT g m a i l .com with your email address)
Cheers, Cameron

@althio

This comment has been minimized.

Copy link
Contributor

althio commented Jul 5, 2017

@kalxas

This comment has been minimized.

Copy link
Author

kalxas commented Jul 5, 2017

Actually I have just merged the pull request to a branch:
https://github.com/OSGeo/OSGeoLive-doc/tree/forvicky
which includes the history of the files.

@althio

This comment has been minimized.

Copy link
Contributor

althio commented Jul 9, 2017

Activity is going on this repository: https://github.com/OSGeo/OSGeoLive-doc
Closing here.

@althio althio closed this Jul 9, 2017

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.