File: MANAGEMENT.md

package info (click to toggle)
sparql-wrapper-python 2.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,228 kB
  • sloc: python: 14,201; makefile: 30
file content (42 lines) | stat: -rw-r--r-- 1,483 bytes parent folder | download
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).