Enhance guidance on using GetConnectors

.github/workflows/markdown-naming-check.yml

@@ -6,13 +6,15 @@ on:
       - main
       - develop
     paths:
-      - 'markdownpages/**.md'
+      - 'markdownpages/**/*.md'
+      - 'markdownpages/*.md'
   pull_request:
     branches:
       - main
       - develop
     paths:
-      - 'markdownpages/**.md'
+      - 'markdownpages/**/*.md'
+      - 'markdownpages/*.md'
   # Allow manual triggering
   workflow_dispatch:
 
@@ -28,16 +30,13 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          # Fetch full history for better file analysis
-          fetch-depth: 0  
+        uses: actions/checkout@v5
 
       # Set up Python environment
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.11'
           cache: 'pip'
 
       # Install dependencies
@@ -72,12 +71,12 @@ jobs:
           # Check which directory exists and run validation accordingly
           if [ -d "markdownpages" ]; then
             python scripts/markdown-naming-check.py --root-path markdownpages --json > validation-report.json
+            validation_exit_code=$?
           else
             echo '{"error": "No markdownpages directory found", "success": false, "total_files_checked": 0, "violations_found": 0, "violations": []}' > validation-report.json
             validation_exit_code=1
           fi
 
-          validation_exit_code=$?
           set -e  # Re-enable exit on error
 
           # Check if there are violations based on exit code
@@ -98,7 +97,7 @@ jobs:
       # Upload validation report as artifact
       - name: Upload validation report
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: markdown-naming-validation-report
           path: validation-report.json
@@ -131,7 +130,7 @@ jobs:
 
     steps:
       - name: Download validation report
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: markdown-naming-validation-report
 

markdownpages/profit/nl/get-connector.md

@@ -16,6 +16,7 @@ Een GetConnector is een endpoint waarmee een applicatie records kan ophalen uit
 - Voeg de GetConnector toe aan de [app connector](https://help.afas.nl/help/NL/SE/App_Apps_Custom_Add.htm "Eigen app connector toevoegen") die gebruikt wordt voor de koppeling.
 
 Met Profit worden standaard-GetConnectoren meegeleverd, maar een beheerder kan zelf een GetConnector aanmaken. Hiermee bepaalt de beheerder zelf welke dataset van toepassing is en via filtering in Profit kan de beheerder de output van de GetConnector beperken. Met een goede GetConnector haal je de gegevens op die voor de koppeling nodig zijn, en niet meer dan dat.
+Het is altijd aan te raden om een nieuwe GetConnector aan te maken, zodat je een bewuste keuze maakt voor de velden die je in de GetConnector opneemt. De meegeleverde GetConnectoren bevatten natuurlijk ook veel velden die niet van belang zijn voor de koppeling die je wilt maken, dus deze velden leveren alleen extra load op. Daarnaast neemt je natuurlijk een filter op in de GetConnector en je neemt in de GetConnector-omschrijving de naam op van de koppeling.
 
 ### Developer van de koppeling
 
@@ -274,4 +275,4 @@ Response:
 
 ## Rowcount op GetConnector
 
-Om een rowcount op een GetConnector te krijgen moet je in AFAS Profit een kopie van de bestaande GetConnector aanmaken. In deze nieuwe GetConnector voeg je een verdichting toe op de sleutel (of op de velden waar je een Count van wilt hebben). De andere velden maak je onzichtbaar. Vraag de AFAS-beheerder om uit te voeren, als je niet zelf in de omgeving kunt. [Functionele beschrijving](https://help.afas.nl/help/NL/SE/App_Query_Cond.htm)
+Om een rowcount op een GetConnector te krijgen moet je in AFAS Profit een kopie van de bestaande GetConnector aanmaken. In deze nieuwe GetConnector voeg je een verdichting toe op de sleutel (of op de velden waar je een Count van wilt hebben). De andere velden maak je onzichtbaar. Vraag de AFAS-beheerder om uit te voeren, als je niet zelf in de omgeving kunt. [Functionele beschrijving](https://help.afas.nl/help/NL/SE/App_Query_Cond.htm)