Merge branch 'develop' into f/OS-110

* develop:
  Added docker compose setup
  Update .github/workflows/pr.yml
  Cleaned up code
  Cleaned up code
  Cleaned up changelog
  Fixed digital post command. Updated GitHub Actions steps.

Author: stankut

.github/workflows/pr.yml

@@ -8,7 +8,7 @@ jobs:
       fail-fast: false
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 2
 
@@ -18,122 +18,65 @@ jobs:
       - name: Check that changelog has been updated.
         run: git diff --exit-code origin/${{ github.base_ref }} -- CHANGELOG.md && exit 1 || exit 0
 
-  test-composer-files:
+  validate-composer-files:
     name: Validate composer
     runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate composer files
+        run: |
+          # Note that we don't use the --strict flag on validate due to the
+          # package drupal/config_entity_revisions 2.0.x-dev being considered a
+          # version cf.
+          # https://getcomposer.org/doc/articles/versions.md#branches
+          docker compose run --rm php composer validate composer.json
+      - name: Check that composer file is normalized
+        run: |
+          docker compose run --rm php composer install
+          docker compose run --rm php composer normalize --dry-run
+
+  test-composer-files:
+    name: Test composer files
+    runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-versions: [ '8.1' ]
         dependency-version: [ prefer-lowest, prefer-stable ]
     steps:
-      - uses: actions/checkout@master
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extensions: json
-          coverage: none
-          tools: composer:v2
-      # https://github.com/shivammathur/setup-php#cache-composer-dependencies
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Validate composer files
+      - uses: actions/checkout@v4
+      - name: Check that dependencies resolve.
         run: |
-          composer config --no-plugins allow-plugins.mglaman/composer-drupal-lenient true
-          composer validate --strict composer.json
-          # Check that dependencies resolve.
-          composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction
+          # Clean up before update (cf. https://www.drupal.org/project/simplesamlphp_auth/issues/3350773)
+          rm -fr vendor/
+          docker compose run --rm php composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction
 
   php-coding-standards:
     name: PHP coding standards
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        php-versions: [ '8.1' ]
     steps:
-      - uses: actions/checkout@master
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extensions: json
-          coverage: none
-          tools: composer:v2
-      # https://github.com/shivammathur/setup-php#cache-composer-dependencies
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
+      - uses: actions/checkout@v4
       - name: Install Dependencies
         run: |
-          composer config --no-plugins allow-plugins.mglaman/composer-drupal-lenient true
-          composer install --no-interaction --no-progress
+          docker compose run --rm php composer install
       - name: PHPCS
         run: |
-          composer coding-standards-check/phpcs
+          docker compose run --rm php composer coding-standards-check/phpcs
 
   php-code-analysis:
     name: PHP code analysis
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        php-versions: [ '8.1' ]
     steps:
-      - uses: actions/checkout@master
-      - name: Setup PHP, with composer and extensions
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: ${{ matrix.php-versions }}
-          extensions: json
-          coverage: none
-          tools: composer:v2
-      # https://github.com/shivammathur/setup-php#cache-composer-dependencies
-      - name: Get composer cache directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-          restore-keys: ${{ runner.os }}-composer-
+      - uses: actions/checkout@v4
       - name: Code analysis
         run: |
           ./scripts/code-analysis
 
-  markdownlint:
+  coding-standards-markdown:
+    name: Markdown coding standards
     runs-on: ubuntu-latest
-    name: markdownlint
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
-      - name: Get yarn cache directory path
-        id: yarn-cache-dir-path
-        run: echo "::set-output name=dir::$(yarn cache dir)"
-      - name: Cache yarn packages
-        uses: actions/cache@v2
-        id: yarn-cache
-        with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
-      - name: Yarn install
-        uses: actions/setup-node@v2
-        with:
-          node-version: '20'
-      - run: yarn install
-      - name: markdownlint
-        run: yarn coding-standards-check/markdownlint
+        uses: actions/checkout@v4
+
+      - name: Coding standards
+        run: |
+          docker compose run --rm markdownlint markdownlint '**/*.md'

.gitignore

@@ -4,5 +4,3 @@
 composer.lock
 vendor
 
-node_modules/
-yarn.lock

.markdownlint.jsonc

@@ -0,0 +1,13 @@
+{
+  "default": true,
+  // https://github.com/DavidAnson/markdownlint/blob/main/doc/md013.md
+  "line-length": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false
+  },
+  // https://github.com/DavidAnson/markdownlint/blob/main/doc/md024.md
+  "no-duplicate-heading": {
+    "siblings_only": true
+  }
+}

.markdownlintignore

@@ -0,0 +1,2 @@
+# https://github.com/igorshubovych/markdownlint-cli?tab=readme-ov-file#ignoring-files
+vendor/

.markdownlintrc

@@ -11,14 +11,19 @@ before starting to add changes. Use example [placed in the end of the page](#exa
 
 ## [Unreleased]
 
+- [PR-168](https://github.com/OS2Forms/os2forms/pull/168)
+  Cleaned up code
+- [PR-166](https://github.com/OS2Forms/os2forms/pull/166)
+  - Fix digital post commands
+  - Updated versions in GitHub Actions `uses` steps
 - Updating the display of os2forms package on the status page
 - Adding os2forms_digital_signature module
 
 ## [4.0.0] 2025-03-06
 
-- This is an alias for for 3.22.2. Major change is the module removal, which can lead to lack of backward support.
-See full release note here:
-https://github.com/OS2Forms/os2forms_docs/blob/master/docs/releases/2024-Q4-Release-notes.md
+- This is an alias for for 3.22.2. Major change is the module removal, which can
+  lead to lack of backward support. See full release note here:
+  <https://github.com/OS2Forms/os2forms_docs/blob/master/docs/releases/2024-Q4-Release-notes.md>
 
 ## [3.22.2] 2025-02-28
 
@@ -93,9 +98,8 @@ https://github.com/OS2Forms/os2forms_docs/blob/master/docs/releases/2024-Q4-Rele
 ## [3.16.0] 2024-08-27
 
 f/OS-115_dawa_address
-- [OS-115] Skipping empty maktrikula objects
-
 
+- [OS-115] Skipping empty maktrikula objects
 
 [#110](https://github.com/OS2Forms/os2forms/pull/110)
 

CHANGELOG.md

@@ -121,30 +121,38 @@ run the checks locally.
 ### PHP
 
 ```sh
-docker run --rm --volume ${PWD}:/app --workdir /app itkdev/php8.1-fpm composer install
-docker run --rm --volume ${PWD}:/app --workdir /app itkdev/php8.1-fpm composer coding-standards-check
-
+docker compose pull
+docker compose run --rm php composer install
 # Fix (some) coding standards issues.
-docker run --rm --volume ${PWD}:/app --workdir /app itkdev/php8.1-fpm composer coding-standards-apply
+docker compose run --rm php composer coding-standards-apply
+docker compose run --rm php composer coding-standards-check
 ```
 
+> [!TIP]
+> If the `composer install` commands fails with
+>
+> > Unable to install module simplesamlphp/simplesamlphp-assets-base, package name must be on the form "VENDOR/simplesamlphp-module-MODULENAME".
+>
+> you can remove the `vendor` folder and rerun the `composer install` command (cf.
+> <https://www.drupal.org/project/simplesamlphp_auth/issues/3350773>).
+
 ### Markdown
 
 ```sh
-docker run --rm --volume ${PWD}:/app --workdir /app node:20 yarn install
-docker run --rm --volume ${PWD}:/app --workdir /app node:20 yarn coding-standards-check/markdownlint
-
-# Fix (some) coding standards issues.
-docker run --rm --volume ${PWD}:/app --workdir /app node:20 yarn coding-standards-apply/markdownlint
+docker compose pull
+docker compose run --rm markdownlint markdownlint '**/*.md' --fix
+docker compose run --rm markdownlint markdownlint '**/*.md'
 ```
 
 ## Code analysis
 
 We use [PHPStan](https://phpstan.org/) for static code analysis.
 
-Running statis code analysis on a standalone Drupal module is a bit tricky, so
-we use a helper script to run the analysis:
+Running statis code analysis on a standalone Drupal module is a bit tricky, so we use a helper script to run the
+analysis:
 
-```sh
-./scripts/code-analysis
+```shell
+docker compose run --rm php ./scripts/code-analysis
 ```
+
+**Note**: Currently the code analysis is only run on the `os2forms_digital_post` sub-module (cf. [`phpstan.neon`](./phpstan.neon)).

README.md

@@ -0,0 +1,17 @@
+# https://hub.docker.com/r/ddev/ddev-php-base
+
+services:
+  php:
+    image: ddev/ddev-php-base
+    profiles:
+      - dev
+    working_dir: /app
+    volumes:
+      - ./:/app
+
+  markdownlint:
+    image: itkdev/markdownlint
+    # The default working dir is `/md`
+    working_dir: /app
+    volumes:
+      - ./:/app