This release is a pre-release and may not be stable for production use.
Giza is a collection of tools built around Sphinx, that coordinates assembling, building, and deploying documentation. Giza primarily addresses the MongoDB documentation project; however, its design is sufficiently generic to be able to facilitate the builds of multiple documentation resources produced at MongoDB.
Resources
File issues in the MongoDB DOCS Jira Project.
Installation
Giza is available in PyPi, and all dependencies and the package handles all dependencies and version management. For most use, you will want to install Giza using the specification in the requirements.txt file in the repository and branch you want to build. Use the following command:
pip install -r requirements.txt
While most branches will use the latest version of the software, at some point in the future, it may only be possible to build some older branches with a specific version of Giza. Using requirements.txt ensure that you will always install the correct version of Giza.
At any time, you can install the latest version with the following pip command:
pip install giza
To install the optional github and jira integration, use the following command:
pip install giza [jira,github]
Additional Components
Beyond the giza command, the Giza package includes several additional utilities that address various needs of the documentation project:
scrumpy provides reports that help us manage our SCRUM and sprint, as well as help with Jira triage and backlog management.
mdbpr is a tool that integrates with Github to identify pull requests that appropriate for merging.
These components are simple but contain additional dependencies and do not share the same root configuration structure with regards to the main giza application. Furthermore, their functionality is not likely to be relevant for a majority of Giza users.
Release files for giza 0.4.1-beta0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| giza-0.4.1-beta0.tar.gz | 112.6 kB | Details |
Release files / giza-0.4.1-beta0.tar.gz
| Download URL | giza-0.4.1-beta0.tar.gz |
|---|---|
| Size | 112.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9f9c879eb32119e9e1d5d08c69bd14249785c4233d6605ebbc1bce2ff2ac1599
|
|
BLAKE2b-256 checksum How to use checksums |
babe1e5e3475568f5019ff9099819ca7fca65dc9da36014ebceec2c4ce09fbaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
