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 directory -
a
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.