k3nny/TISbackup
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README.md and tranquil-it-contacts.rst

Browse Source
This commit is contained in:
Vincent CARDON
2020-11-23 15:34:28 +01:00
parent 80283ca133
commit 4e4165958b
3 changed files with 8 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/README.md
-50
View File
@@ -1,50 +0,0 @@
TIS-backup Documentation
========================
This is the documentation repository of the TIS-backup project. The documentation is provided under the licence CC-BY-SA.
How to contribute?
==================
You must install documentation tools and requirements before doing anything :
```bash
sudo sh ./install_requirements.sh
```
Once installed, pre-commit checks (lint/syntax) are launched prior to committing your changes. To launch tests manually, you can run the following :
```bash
pre-commit run --all-files
```
This should (take a while because sphinx-build) return :
```bash
Trim Trailing Whitespace.................................................Passed
Fix End of Files.........................................................Passed
rst ``code`` is two backticks............................................Passed
sphinx build.............................................................Passed
```
How to push documentation to public ?
=====================================
Pushing the documentation through a rsync is bad.
To publish WAPT documentation to public, a 'release-' tag must be set using git.
Once a release tag has been set, it creates a tagged build which must be launched manually in Jenkins.
```bash
git add *
git commit -m 'I have checked it builds without errors, trust me'
git push
git tag -a release-1.8.1.6694-doc -m "WAPT documentation publish for 1.8.1.6694"
git push origin --tags
```
Once that tag has been pushed, in Jenkins you have to re-scan the multibranches project and go to `Tags` tab, select your tag and build it.
Wait for the entire build to go through, it will publish everything according to JenkinsFile procedure.
doc/source/tranquil-it-contacts.rst
+1 -7
View File
@@ -8,18 +8,12 @@
.. meta::
:description: Contacting Tranquil IT
:keywords: WAPT, documentation, website, editor,
Twitter, Linkedin, Forum, Mailing List, official website
Twitter, official website
.. _contact_tranquil_it:
Contacting Tranquil IT
======================
Contact us for more informations:
* Tranquil IT: https://www.tranquil.it/
* Twitter: https://twitter.com/tranquil_it
* Linkedin: https://www.linkedin.com/company/tranquil-it
* Forum in French: https://forum.tranquil.it/
* Forum in English: https://www.reddit.com/r/WAPT
* Mailing-list: https://lists.tranquil.it/listinfo/wapt