This is a public git repository for documentation about
various project management tools and related software.
It basically contains information for users, tips, tricks and small how-to-do descriptions.
Create an account in Github.
Fork the
masterrepository.Install
giton your computer.Create a local repository (by cloning your fork).
Create a branch to store your work (e.g.
myChangesToRequirements).Make changes, local commits, etc..
Commit to your fork.
When you want your changes to be reviewed and integrated into the
master, send apull request.Your changes will be reviewed and merged into the main branch.
Update your repositories to avoid conflicts.
Please read /docs/build/html/On_VersionControl/UsingGit.rst
Textual information is stored in reStructured Text files (rst files).
Please read /docs/build/html/On_Documentation/OnReStructuredText.rst
Images are stored in png format.
The documents are stored in:
- the
/docs/source/folders.
Please do not change:
- the
.gitignorefile - the
/docs/makefileand themosy/docs/make.batfile (required by Sphinx) - the
/docs/source/conf.pyfile (required by Sphinx) - the
/docs/_staticdirectory - the
/docs/_templatesdirectory - the
/docs/_themesdirectory - the
/utilsdirectory content
Each subdirectory (may) contain:
an
index.rstfile with the partial table of contents of the directorya
Z_GenericLinks.rstfile with all the hyperlinks required by the documents in the directory. An..include::directive is used to include the file at the end of ther refereing documents (after the.. links-placeholder.a
Z_References.rstfile containing bibliographic references. Later on, this files will be consolidated into a bibtex file, and all citations will be changed accordingly.an
imgdirectory containing images used in the documents.