From 5a18117464c46e2efec51eed24f0f879fd06dd87 Mon Sep 17 00:00:00 2001 From: xtof Date: Mon, 20 Apr 2020 20:23:02 +0200 Subject: [PATCH 1/3] Doc - add naming convention --- ModuleCubesatSim/pom.xml | 7 +-- pom.xml | 42 ++++++++++++- src/site/markdown/MarkdownSyntax.md | 89 +++++++++++++++++++++++++++ src/site/markdown/namingconvention.md | 31 ++++++++++ src/site/site.xml | 42 +++++++++++++ 5 files changed, 203 insertions(+), 8 deletions(-) create mode 100644 src/site/markdown/MarkdownSyntax.md create mode 100644 src/site/markdown/namingconvention.md create mode 100644 src/site/site.xml diff --git a/ModuleCubesatSim/pom.xml b/ModuleCubesatSim/pom.xml index 9e63da53..d8e48ebd 100644 --- a/ModuleCubesatSim/pom.xml +++ b/ModuleCubesatSim/pom.xml @@ -72,12 +72,7 @@ - -org.junit.jupiter - junit-jupiter-engine - 5.5.2 - test - + diff --git a/pom.xml b/pom.xml index 52848269..2fa6197d 100644 --- a/pom.xml +++ b/pom.xml @@ -15,8 +15,36 @@ https://code.electrolab.fr/xtof/josast - - + + + Amsat-Francophone + http://www.amsat-f.org + + + + GNU LESSER GENERAL PUBLIC LICENSE 2.1 + https://www.gnu.org/licenses/old-licenses/gpl-2.0.fr.html + + + + + + + + Christophe Mercier + Christophe + christophe.mcr+josast@gmail.com + +1 + Amsat-Francophone + http://www.amsat-f.org + + Tech lead + développeur + + + + + UTF-8 1.8 @@ -671,6 +699,16 @@ + + + + + + + site-projet + scp://exemple.org/www/ + + diff --git a/src/site/markdown/MarkdownSyntax.md b/src/site/markdown/MarkdownSyntax.md new file mode 100644 index 00000000..514db39f --- /dev/null +++ b/src/site/markdown/MarkdownSyntax.md @@ -0,0 +1,89 @@ +# Markdown Syntax # + +The [Maven doxia module] for [Markdown] uses the [pegdown] processor +to render HTML. Pegdown supports several extensions to the Markdown +syntax. This documents shows example of syntax you can use in your +Maven site and the results. + +## Text ## + +| Markup | Result | +|:-----------------------------------:|:-------------------------------:| +| ``This text is **strong**.`` | This text is **strong**. | +| ``This text is also __strong__.`` | This text is also __strong__. | +| ``This text is *emphasized*.`` | This text is *emphasized* | +| ``This text is also _emphasized_.`` | This text is also _emphasized_. | +| ```This is ``some code``.``` | This is ``some code``. | +| ``This is also ```some code```.`` | This is also ```some code```. | + +## Headings ## + +See [this page](headings.html). + +## Lists ## + +## Links ## + +## Images ## + +## Code ## + +## Footnotes ## + +Here is some text containing a footnote[^somesamplefootnote]. You can then continue your thought... + +[^somesamplefootnote]: Here is the text of the footnote itself. + +Even go to a new paragraph and the footnotes with go to the bottom of the document[^documentdetails]. + +[^documentdetails]: Depending on the final form of your document, of course. See the documentation and experiment. + + This footnote has a second paragraph. + +## Tables ## + +### Simple Table ### + +#### Markup #### + +``` +| First Header | Second Header | Third Header | +| :----------- | :-----------: | -------------------: | +| First row | Data | Very long data entry | +| Second row | **Cell** | *Cell* | +``` + +#### Result #### + +| First Header | Second Header | Third Header | +| :----------- | :-----------: | -------------------: | +| First row | Data | Very long data entry | +| Second row | **Cell** | *Cell* | + +### Table with cells spanning multiple columns ### + +#### Markup #### + +``` +| | Grouping || +| First Header | Second Header | Third Header | +| ------------ | :-----------: | -----------: | +| Content | *Long Cell* || +| Content | **Cell** | Cell | +| New section | More | Data | +``` + +#### Result #### + +| | Grouping || +| First Header | Second Header | Third Header | +| ------------ | :-----------: | -----------: | +| Content | *Long Cell* || +| Content | **Cell** | Cell | +| New section | More | Data | + + +[Maven doxia module]: http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-markdown/ +[Markdown]: http://daringfireball.net/projects/markdown/ "Main Markdown site" +[pegdown]: https://github.com/sirthias/pegdown + diff --git a/src/site/markdown/namingconvention.md b/src/site/markdown/namingconvention.md new file mode 100644 index 00000000..77b8a0e2 --- /dev/null +++ b/src/site/markdown/namingconvention.md @@ -0,0 +1,31 @@ +# JOSAST naming convention + +## Application / Module / Web application + + An **Application** is an executable jar. Two types of application can be produce + + * Command line application + * Graphic application + + A **Module** is a library jar. A module address a functionality. An application is an integration of modules. + + A **Web Application** is jar / war used for a web service. + +### naming convention + +| type | Rule | +| :-----------------------:| :---------------------------:| +| Application Command line | **Application***name***cli** | +| Application HMI | **Application**Name | +| Module | **Module**Name | +| Web Application | **Web**Name | + + +## package naming convention + +The package naming convention is the following : + + * **org.josast.***name*.*...* + * The *name* is the name + + \ No newline at end of file diff --git a/src/site/site.xml b/src/site/site.xml new file mode 100644 index 00000000..5fc4af9f --- /dev/null +++ b/src/site/site.xml @@ -0,0 +1,42 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file -- GitLab From 13e5190f923c79dc864cd97a421a14b999cab586 Mon Sep 17 00:00:00 2001 From: xtof Date: Fri, 24 Apr 2020 18:28:51 +0200 Subject: [PATCH 2/3] docs : add commit message & setup site xml for all modules --- ApplicationEntrySatDecoder/src/site/site.xml | 35 ++++++++++++++++++++ ModuleAmicalsat/src/site/site.xml | 35 ++++++++++++++++++++ ModuleConfig/src/site/site.xml | 35 ++++++++++++++++++++ ModuleCubesatSim/src/site/site.xml | 35 ++++++++++++++++++++ ModuleEquationKepler/src/site/site.xml | 35 ++++++++++++++++++++ ModuleInflux/src/site/site.xml | 35 ++++++++++++++++++++ ModuleJourJulien/src/site/site.xml | 35 ++++++++++++++++++++ ModuleSound/src/site/site.xml | 35 ++++++++++++++++++++ ModuleSoundModem/src/site/site.xml | 35 ++++++++++++++++++++ ModuleUtil/src/site/site.xml | 35 ++++++++++++++++++++ src/site/markdown/namingconvention.md | 22 +++++++++++- 11 files changed, 371 insertions(+), 1 deletion(-) create mode 100644 ApplicationEntrySatDecoder/src/site/site.xml create mode 100644 ModuleAmicalsat/src/site/site.xml create mode 100644 ModuleConfig/src/site/site.xml create mode 100644 ModuleCubesatSim/src/site/site.xml create mode 100644 ModuleEquationKepler/src/site/site.xml create mode 100644 ModuleInflux/src/site/site.xml create mode 100644 ModuleJourJulien/src/site/site.xml create mode 100644 ModuleSound/src/site/site.xml create mode 100644 ModuleSoundModem/src/site/site.xml create mode 100644 ModuleUtil/src/site/site.xml diff --git a/ApplicationEntrySatDecoder/src/site/site.xml b/ApplicationEntrySatDecoder/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ApplicationEntrySatDecoder/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleAmicalsat/src/site/site.xml b/ModuleAmicalsat/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleAmicalsat/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleConfig/src/site/site.xml b/ModuleConfig/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleConfig/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleCubesatSim/src/site/site.xml b/ModuleCubesatSim/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleCubesatSim/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleEquationKepler/src/site/site.xml b/ModuleEquationKepler/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleEquationKepler/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleInflux/src/site/site.xml b/ModuleInflux/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleInflux/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleJourJulien/src/site/site.xml b/ModuleJourJulien/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleJourJulien/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleSound/src/site/site.xml b/ModuleSound/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleSound/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleSoundModem/src/site/site.xml b/ModuleSoundModem/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleSoundModem/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModuleUtil/src/site/site.xml b/ModuleUtil/src/site/site.xml new file mode 100644 index 00000000..6c235d50 --- /dev/null +++ b/ModuleUtil/src/site/site.xml @@ -0,0 +1,35 @@ + + + + + org.apache.maven.skins + maven-fluido-skin + 1.6 + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/site/markdown/namingconvention.md b/src/site/markdown/namingconvention.md index 77b8a0e2..b63a2d8a 100644 --- a/src/site/markdown/namingconvention.md +++ b/src/site/markdown/namingconvention.md @@ -28,4 +28,24 @@ The package naming convention is the following : * **org.josast.***name*.*...* * The *name* is the name - \ No newline at end of file +## Semantic Commit Messages + + +Format: `(): ` + +`` is optional + + +- `feat`: (new feature for the user, not a new feature for build script) +- `fix`: (bug fix for the user, not a fix to a build script) +- `docs`: (changes to the documentation) +- `style`: (formatting, missing semi colons, etc; no production code change) +- `refactor`: (refactoring production code, eg. renaming a variable) +- `test`: (adding missing tests, refactoring tests; no production code change) +- `chore`: (updating grunt tasks etc; no production code change) + +References: + +- https://www.conventionalcommits.org/ +- https://seesparkbox.com/foundry/semantic_commit_messages +- http://karma-runner.github.io/1.0/dev/git-commit-msg.html \ No newline at end of file -- GitLab From 532c645bcf945af5d6c278ca53cfeb423a303733 Mon Sep 17 00:00:00 2001 From: xtophe Date: Wed, 29 Apr 2020 19:00:34 +0200 Subject: [PATCH 3/3] dos: modify naming convention --- ApplicationAmicalsatCli/pom.xml | 6 ++++++ .../org/josast/CubesatSim/influxDB/InfluxDBInstance.java | 4 ++-- .../josast/CubesatSim/influxDB/InfluxDatabaseConfig.java | 2 +- src/site/markdown/namingconvention.md | 4 ++-- 4 files changed, 11 insertions(+), 5 deletions(-) diff --git a/ApplicationAmicalsatCli/pom.xml b/ApplicationAmicalsatCli/pom.xml index 81d8db87..98b14755 100644 --- a/ApplicationAmicalsatCli/pom.xml +++ b/ApplicationAmicalsatCli/pom.xml @@ -101,6 +101,12 @@ + + + + + + diff --git a/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDBInstance.java b/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDBInstance.java index ae2667fc..4fa4d406 100644 --- a/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDBInstance.java +++ b/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDBInstance.java @@ -8,14 +8,14 @@ import org.influxdb.InfluxDBIOException; import org.influxdb.dto.BatchPoints; import org.influxdb.dto.Pong; -/** - * Manage InflusDB Instance. +/** Manage InflusDB Instance. * * @author christophe * */ public final class InfluxDBInstance { + /** log */ private Logger log = Logger.getLogger(getClass().getName()); static InfluxDBInstance influxDB = null; diff --git a/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDatabaseConfig.java b/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDatabaseConfig.java index 93f1692a..ebb4bc07 100644 --- a/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDatabaseConfig.java +++ b/ModuleCubesatSim/src/main/java/org/josast/CubesatSim/influxDB/InfluxDatabaseConfig.java @@ -15,7 +15,7 @@ public class InfluxDatabaseConfig extends ConfigObject { /** * @param configFilename */ - public InfluxDatabaseConfig(String configFilename) { + public InfluxDatabaseConfig(final String configFilename) { super(configFilename); String temp = ConfigFile.GetProperty("adresse"); diff --git a/src/site/markdown/namingconvention.md b/src/site/markdown/namingconvention.md index b63a2d8a..418f4eb2 100644 --- a/src/site/markdown/namingconvention.md +++ b/src/site/markdown/namingconvention.md @@ -25,8 +25,8 @@ The package naming convention is the following : - * **org.josast.***name*.*...* - * The *name* is the name + **org.josast.***name*.*...* + The *name* is the module name ## Semantic Commit Messages -- GitLab