1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
|
# Management documentation
The project keeps a very low-profile on managing, so we try to keep it simple.
## Contributions
Every contributor (patchs, pull requests, new features, etc) gets part of ownership by be mentioned as contributor to the project (`AUTHORS.md`).
## Release
### Software
The release process is quite simple, just few things have to be done:
First, do not forget to update the changelog (`ChangeLog.txt` file). That information could be added later to the release at github.
Then you have to [create a release](https://github.com/blog/1547-release-your-software) by tagging the master branch:
git tag x.y.z
git push --tags
And then upload the release to pypi:
python setup.py sdist && twine upload dist/*
Please, don't forget to increment to the next module (`SPARQLWrapper/__init__.py` file).
### Documentation
In order to provide offline documentation, some steps need to be accomplished:
1. First, generate the documentation using [sphinx](http://www.sphinx-doc.org/) using the makefile
$ cd docs
$ make clean && make html
Previously, [epydoc](http://epydoc.sourceforge.net/) was used for generating the documentation and make it available online, through two additional steps:
2. And then upload the documentation generated (`doc` folder) to GitHub Pages (`gh-pages` branch).
3. After that, the online version of the documentation would be available on [GitHub Pages](http://rdflib.github.io/sparqlwrapper/resources/doc).
|