WIP

.github/workflows/markdown-lint.yml

@@ -0,0 +1,21 @@
+---
+name: Markdown lint
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  vale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: errata-ai/[email protected]
+        with:
+          fail_on_error: true
+          filter_mode: nofilter
+          vale_flags: "--glob=*.md --config=tests/.vale.ini"

CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Changelog with backdated changes (#72).
+
+## [10.5.1] - 2024-05-23
+
+### Changed
+
+- Update to [version 10.5.1 of SonarQube](https://www.sonarsource.com/products/sonarqube/whats-new/sonarqube-10-5/) (#76).
+
+## [10.3.0] - 2023-12-22
+
+### Changed
+
+- Update to [version 10.3.0 of SonarQube](https://www.sonarsource.com/products/sonarqube/whats-new/sonarqube-10-3/) (#55).
+
+## [10.1.0] - 2023-09-05
+
+### Changed
+
+- Update to [version 10.1.0 of SonarQube](https://www.sonarsource.com/products/sonarqube/whats-new/sonarqube-10-1/) (#52).
+
+## [9.9.1] - 2023-05-09
+
+### Changed
+
+- Update to version 9.9.1 of SonarQube.
+
+## [9.7.1] - 2022-12-02
+
+### Changed
+
+- Update to version 9.7.1 of SonarQube.

MAINTENANCE.md

@@ -33,10 +33,10 @@ Modify the [config.json](https://github.com/ICTU/sonar/blob/master/src/config.js
     },
 
 The parameters are:
-* (key): language (internal SonarQube language identifier) 
-* plugin_name: name of the plugin to be used for this profile
-* plugin_external: true for external plugin, false (default) when it is contained in the base container image
-* version: profile version string (based on the plugin version)
+* `(key)`: language (internal SonarQube language identifier) 
+* `plugin_name`: name of the plugin to be used for this profile
+* `plugin_external`: true for external plugin, false (default) when it is contained in the base container image
+* `version`: profile version string (based on the plugin version)
 
 
 ## Create rule entries from SonarQubes quality profile backup (xml)

README.md

@@ -1,6 +1,6 @@
 # ICTU SonarQube container image
 
-A SonarQube container image with plugins, profiles and config used at ICTU
+A SonarQube container image with plugins, profiles and configuration used at ICTU
 
 
 ## Creating a new quality profile
@@ -28,7 +28,7 @@ It is also possible to adjust individual rule parameter values:
     PROJECT_RULES=+csharpsquid:S110|max=6;-ts:S1561
 
 
-## Running with PostgreSQL via a docker composition
+## Running with PostgreSQL via a Docker-composition
 
 Example docker-compose file:
 

tests/.vale.ini

@@ -0,0 +1,9 @@
+StylesPath = styles
+
+MinAlertLevel = suggestion
+Vocab = Base
+
+Packages = proselint
+
+[*.md]
+BasedOnStyles = Vale, proselint

tests/requirements.txt

@@ -1,2 +1,3 @@
 python-sonarqube-api >= 2.0
 requests >= 2.31
+vale >= 3.9.0.0

tests/styles/config/vocabularies/Base/accept.txt

@@ -0,0 +1,66 @@
+Anchore
+APIs
+Caddy
+Checkmarx
+Cobertura
+Dependabot
+Docker-composition
+Dockerfile
+DTDs
+ESLint
+Gravatar
+Jira
+JMeter
+JUnit
+NCover
+Nginx
+OJAudit
+OpenShift
+PDFs
+Pydantic
+Robocop
+Snyk
+Trello
+Trivy
+UUIDs
+Wekan
+[Hh]ostname
+[Uu]nmerged
+asyncio
+autoformatting
+breakpoint
+clearable
+cloc
+discoverability
+donut
+errored
+favicon
+fixme
+hostnames?
+hotspots?
+lookback
+misconfigured
+mypy
+namespace
+npm
+parameterizable
+phpldapadmin
+[Pp]erformancetest
+severities
+sparkline
+subfolders
+submenus
+suppressions
+todo
+tooltips?
+tracebacks?
+unencrypted
+unicode
+unmerged
+upvotes
+url
+xml
+Dennie
+Bouman
+Suchow
+Redistributions

tests/styles/config/vocabularies/Base/reject.txt

@@ -0,0 +1,3 @@
+docker composition
+Docker composition
+docker-composition