This is an experiment in using GitHub to create specifications.
The abstract specification is in the [spec/poi.adoc] (spec/poi.adoc) file.
To contribute find an issue in the [tracker] (https://github.com/opengeospatial/poi/issues) and make a pull request.
If you are a github newbie then just hit 'edit' on the [poi.adoc page] (https://github.com/opengeospatial/poi/blob/master/spec/poi.adoc). This will automatically 'fork' the repository in to your own copy. After editing there you can create a 'pull request' from your fork to submit the work for review and merging.
If you are making a more substantial set of changes please create a branch to work on the set. Pull requests stay with the branches they are made on, so if you make more changes based on feedback that can all get pulled in when ready. Note you can create new branches as well as new files completely through the web.
Here are some technical resources to get you going with Git, GitHub, and asciidoc:
- [Git cheat sheet] (http://zrusin.blogspot.com/2007/09/git-cheat-sheet.html)
- [Git cheat sheet] (http://cheat.errtheblog.com/s/git)
- [asciidoc manual] (http://www.methods.co.nz/asciidoc/)
- [asciidoc cheat sheet] (http://powerman.name/doc/asciidoc)