update documentation for build and integration test

Author: Turiok

CONTRIBUTING.md

@@ -1,25 +1,30 @@
 # Contributing to i-Code CNES plugin for SonarQube
 First off, thanks for taking the time to contribute!
-The following is a set of guidelines for contributing to i-Code CNES plugin for SonarQube, which are hosted in the [Lequal Organization](https://github.com/lequal) on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
+The following is a set of guidelines for contributing to i-Code CNES plugin for SonarQube, which are hosted in the [CATLab organization](https://github.com/cnescatlab) on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
 
 #### Table Of Contents
-+ [Code of Conduct](#code-of-conduct)
-+ [How Can I Contribute?](#how-can-i-contribute)  
-  * [Reporting Bugs](#reporting-bugs)  
-  * [Suggesting Enhancements](#suggesting-enhancements)  
-  * [Pull Requests](#pull-requests)
-  * [Git Commit Messages](#git-commit-messages)
+- [Contributing to i-Code CNES plugin for SonarQube](#contributing-to-i-code-cnes-plugin-for-sonarqube)
+      - [Table Of Contents](#table-of-contents)
+  - [Code of Conduct](#code-of-conduct)
+  - [How Can I Contribute?](#how-can-i-contribute)
+    - [Reporting Bugs](#reporting-bugs)
+      - [How Do I Submit A (Good) Bug Report?](#how-do-i-submit-a-good-bug-report)
+    - [Suggesting Enhancements](#suggesting-enhancements)
+      - [How Do I Submit A (Good) Enhancement Suggestion?](#how-do-i-submit-a-good-enhancement-suggestion)
+    - [Pull Requests](#pull-requests)
+    - [Git Commit Messages](#git-commit-messages)
+  - [Management of contributions](#management-of-contributions)
 
 ## Code of Conduct
-This project and everyone participating in it is governed by the [Lequal Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
+This project and everyone participating in it is governed by the [CATLab Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to us or [GitHub](https://github.com/contact/report-content).
 
 ## How Can I Contribute?
 
 ### Reporting Bugs
-Before creating bug reports, please check if the problem has already been reported. 
+Before creating bug reports, please check if the problem has already been reported.
 
 #### How Do I Submit A (Good) Bug Report?
-Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/). 
+Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/).
 Provide information by filling [the template](.github/ISSUE_TEMPLATE/bug_report.md).
 
 Explain the problem and include additional details to help maintainers reproduce the problem:
@@ -32,7 +37,7 @@ Explain the problem and include additional details to help maintainers reproduce
 
 Provide more context by answering these questions:
 * **Did the problem start happening recently** (e.g. after updating to a new version of the plugin or SonarQube) or was this always a problem?
-* If the problem started happening recently, **can you reproduce the problem in an older version?** What's the most recent version in which the problem doesn't happen? You can download older versions from [the releases page](https://github.com/lequal/sonar-icode-cnes-plugin/releases).
+* If the problem started happening recently, **can you reproduce the problem in an older version?** What's the most recent version in which the problem doesn't happen? You can download older versions from [the releases page](https://github.com/cnescatlab/sonar-icode-cnes-plugin/releases).
 * **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.
 
 Include details about your configuration and environment:
@@ -72,8 +77,69 @@ Enhancement suggestions are tracked as [GitHub issues](https://guides.github.com
 
 All contributions are welcome. They are made via a *pull request* on the branch `dev` which is the branch of the next version.
 
-* pull request with **major** changes must be approved by at least one maintainer of each team and the LEQUAL.
+* pull request with **major** changes must be approved by at least one maintainer of each team and the CATLab.
 
 * pull requests with **minor** changes must be approved by at least one organization's member.
- 
+
 All maintainers have the ability to merge *pull requests* on the `dev` branch. If several maintainers belong to the same team, their validation only counts for one organization.
+
+# Development
+## How to build
+
+This plugin is mainly developped in Java* and build with maven**. It's main dependencies are [fr.cnes.icode.icode-library](https://github.com/cnescatlab/i-CodeCNES) and libraries for [SonarQube](https://docs.sonarsource.com/sonarqube-community-build/extension-guide/developing-a-plugin/plugin-basics/)
+
+> \* Depending the version, the JDK version is written in the [pom.xml](pom.xml) ans the SonarQube compatibility is in the matrix: [matrix](README.md#run-i-code-automatically)
+>
+> \*\* the build for the release version are validated in maven 3.9.9
+
+
+The icode-library is available on github repository. You'll have to configured your maven settings.xml with a new repository like this:
+
+```xml
+<repositories>
+  <repository>
+    <id>github</id>
+    <url>https://maven.pkg.github.com/cnescatlab/*</url>
+  </repository>
+</repositories>
+```
+
+For all other dependencies, maven [central](https://central.sonatype.com/) is enough.
+
+After that, you only have to launch the build command:
+
+```bash
+mvn package
+```
+
+The jar will be in the **target** folder.
+
+## How to launch integration test
+
+An integration test is written to validate the plugin in a SonarQube dockerized instance and with a Fortran scan.
+
+** [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/) is needed for this integration test
+
+There is 2 scripts to make the test:
+- The [it.sh](it/it.sh) to launch a SonarQube docker instance and install the local sonar-icode-cnes-plugin-<MAVEN_VERSION>.jar in this instance.
+- the [audit.sh](it/audit.sh) to make a sonar-scanner launch a Fortran 77 and Fortran 90 code in the [src](it/src/) folder. This script check f77 and f90 issues a shown by SonarQube using the API.
+
+
+The it script can use parameters:
+```bash
+$> ./it.sh -h
+
+Usage: ./it.sh [sSh]
+
+-h : Display help
+-s [SONAR-SCANNER] : Take Sonar-scanner tag image from https://hub.docker.com/r/sonarsource/sonar-scanner-cli. Default is the latest tag
+-S [SONARQUBE] : Take SonarQube tag image from https://hub.docker.com/_/sonarqube. Default is the community tag
+```
+
+Example of launching :
+```bash
+cd it
+./it.sh -s 11.4.0.2044_7.2.0 -S lts-community
+```
+
+> Be careful to choose version depending the [compatibility matrix](README.md#run-i-code-automatically)

README.md

@@ -81,7 +81,7 @@ Please report issues at https://github.com/leqcnescatlabual/i-CodeCNES/issues
 ````
 
 ### How to contribute
-If you experienced a problem with the plugin please open an issue. Inside this issue please explain us how to reproduce this issue and paste the log. 
+If you experienced a problem with the plugin please open an issue. Inside this issue please explain us how to reproduce this issue and paste the log.
 
 If you want to do a PR, please put inside of it the reason of this pull request. If this pull request fix an issue please insert the number of the issue or explain inside of the PR how to reproduce this issue.
 

it/it.sh

@@ -3,8 +3,8 @@
 usage(){
     echo -e "\nUsage: $0 [sSh] \n"
     echo "-h : Display help"
-    echo "-s [SONAR-SCANNER] : Take Sonar-scanner tag image from https://hub.docker.com/r/sonarsource/sonar-scanner-cli"
-    echo "-S [SONARQUBE] : Take SonarQube tag image from https://hub.docker.com/_/sonarqube"
+    echo "-s [SONAR-SCANNER] : Take Sonar-scanner tag image from https://hub.docker.com/r/sonarsource/sonar-scanner-cli". Default is the latest tag
+    echo "-S [SONARQUBE] : Take SonarQube tag image from https://hub.docker.com/_/sonarqube". Default is the community tag
 }
 
 OPTSTRING=":s:S:h"