feat: add global defaults.normalization_context.gen_id configuration option

.editorconfig

@@ -20,36 +20,29 @@ indent_style = space
 indent_size = 2
 
 [*.md]
+max_line_length = 100
 trim_trailing_whitespace = false
+indent_size = 4
 
 [*.neon]
 indent_style = tab
 indent_size = 4
 
 [*.xml]
-indent_style = space
 indent_size = 4
 
 [*.{yaml,yml}]
-indent_style = space
 indent_size = 2
 trim_trailing_whitespace = false
 
 [.circleci/config.yml]
-indent_style = space
 indent_size = 2
 
 [.github/workflows/*.yml]
-indent_style = space
 indent_size = 2
 
 [.gitmodules]
 indent_style = tab
 
 [.proselintrc]
-indent_style = space
-indent_size = 2
-
-[.travis.yml]
-indent_style = space
 indent_size = 2

.github/ISSUE_TEMPLATE/1_Support_question.md

@@ -5,8 +5,8 @@ about: See https://api-platform.com/support/ for questions about using API Platf
 
 # Support question
 
-We use GitHub issues only to discuss bugs and new features.
-For this kind of questions about using API Platform, please use
-any of the support alternatives shown in [API Platform support](https://api-platform.com/support/).
+We use GitHub issues only to discuss bugs and new features. For this kind of questions about using
+API Platform, please use any of the support alternatives shown in
+[API Platform support](https://api-platform.com/support/).
 
 Thanks!

.github/workflows/cd.yml

@@ -45,7 +45,7 @@ jobs:
       - name: Install php
         uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.2"
+          php-version: "8.4"
           tools: phive
 
       - name: Auth gcloud

.github/workflows/ci.yml

@@ -9,29 +9,12 @@ permissions:
   contents: read
 
 jobs:
-  build:
-    name: Lint
+  proselint:
+    name: Prose Lint
     runs-on: ubuntu-latest
-
-    permissions:
-      contents: read
-      packages: read
-      statuses: write
-
     steps:
-      - name: Checkout
+      - name: Checkout code
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Lint
-        uses: super-linter/super-linter/slim@v7
-        env:
-          VALIDATE_EDITORCONFIG: false
-          VALIDATE_JSCPD: false
-          VALIDATE_MARKDOWN_PRETTIER: false
-          DEFAULT_BRANCH: "origin/4.1"
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - uses: actions/cache@v4
         with:
@@ -45,3 +28,40 @@ jobs:
 
       - name: Run Proselint
         run: find . -name '*.md' -exec proselint {} \;
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - uses: DavidAnson/markdownlint-cli2-action@v21
+        with:
+          globs: '**/*.md'
+
+  prettier-format:
+    name: Prettier
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Prettier Dry Run
+        run: |
+          npx prettier --check "**/*.md" || {
+            echo "::error title=Formatting Failed::Some files are not formatted correctly."
+            echo "-------------------------------------------------------"
+            echo "❌ CHECK FAILED"
+            echo "To fix these issues, run the following command locally:"
+            echo ""
+            echo "    npx prettier --write \"**/*.md\" --prose-wrap always"
+            echo ""
+            echo "-------------------------------------------------------"
+            exit 1
+            }

.markdownlint.yaml

@@ -0,0 +1,13 @@
+---
+MD013:
+  line_length: 1000
+  code_blocks: false
+  tables: false
+no-inline-html:
+  allowed_elements: [a, p, img, br, code-selector, video, source, iframe, h1]
+MD046:
+  style: fenced
+MD004:
+  style: dash
+MD007:
+  indent: 4

.prettierrc

@@ -0,0 +1,4 @@
+{
+  "printWidth": 100,
+  "proseWrap": "always"
+}

CONTRIBUTING.md

@@ -2,7 +2,8 @@
 
 First of all, thank you for contributing, you're awesome!
 
-To have your code integrated in the API Platform documentation project, there are some rules to follow, but don't panic, it's easy!
+To have your code integrated in the API Platform documentation project, there are some rules to
+follow, but don't panic, it's easy!
 
 ## Reporting Bugs in the documentation
 
@@ -12,29 +13,36 @@ Before submitting your issue:
 - A clear title to resume the issue
 - A description of the workflow needed to reproduce the bug
 
-> [!NOTE]
-> Don't hesitate giving as much information as you can.
+> [!NOTE] Don't hesitate giving as much information as you can.
 
 ## Code of Conduct
 
-By contributing to this project, you agree to abide by our [Code of Conduct](https://github.com/api-platform/docs#coc-ov-file). We expect all contributors to foster a welcoming and inclusive environment.
+By contributing to this project, you agree to abide by our
+[Code of Conduct](https://github.com/api-platform/docs#coc-ov-file). We expect all contributors to
+foster a welcoming and inclusive environment.
 
 ## How to Contribute
 
-1. Fork this repository by clicking the "Fork" button at the top right of the `api-platform/docs` repository page.
+1. Fork this repository by clicking the "Fork" button at the top right of the `api-platform/docs`
+   repository page.
 
 2. Clone the forked repository to your local machine:
-   ```console
-     git clone https://github.com/your-username/repository-name.git
-   ```
+
+    ```console
+      git clone https://github.com/your-username/repository-name.git
+    ```
+
 3. Create a new branch for your contribution:
-   ```console
-     git switch -c docs-your-branch-name
-   ```
+
+    ```console
+      git switch -c docs-your-branch-name
+    ```
+
 4. Commit and push your changes
-5. Submit a Pull Request. You must decide on what branch your changes will be based depending of the nature of the change.
-   See [the dedicated documentation entry](https://api-platform.com/docs/extra/releases/).
+5. Submit a Pull Request. You must decide on what branch your changes will be based depending of the
+   nature of the change. See
+   [the dedicated documentation entry](https://api-platform.com/docs/extra/releases/).
 
-> [!TIP]
-> You can also contribute to improving the documentation directly by clicking on the
-> **"You can also help us improve the documentation of this page."** link, located at the end of each documentation page.
+> [!TIP] You can also contribute to improving the documentation directly by clicking on the **"You
+> can also help us improve the documentation of this page."** link, located at the end of each
+> documentation page.

README.md

@@ -4,11 +4,11 @@
 
 [![Lint](https://github.com/api-platform/docs/actions/workflows/ci.yml/badge.svg)](https://github.com/api-platform/docs/actions/workflows/ci.yml)
 
-Welcome to the official documentation for [API Platform](https://api-platform.com), a powerful framework for building APIs and web applications.
+Welcome to the official documentation for [API Platform](https://api-platform.com), a powerful
+framework for building APIs and web applications.
 
 This repository contains all the API Platform documentation resources.
 
 ## Contributing
 
 Please check our [CONTRIBUTING file](/CONTRIBUTING.md) to contribute.
-