Merge pull request #3677 from ClickHouse/linter_spellcheck

restructure linting and checks

Author: gingerwizard

.github/workflows/check-build.yml

@@ -24,15 +24,10 @@ jobs:
         if: matrix.check_type == 'spellcheck'
         run: sudo apt-get update && sudo apt-get install -y aspell aspell-en
       - name: Set up Python
-        if: matrix.check_type == 'kbcheck'
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
-      - name: Install dependencies
         if: matrix.check_type == 'kbcheck'
         run: |
-          python -m pip install --upgrade pip
-          pip install -r 'scripts/knowledgebase-checker/requirements.txt'
+          curl -Ls https://astral.sh/uv/install.sh | sh
+          uv python install 3.12
       - name: Setup md-lint environment
         if: matrix.check_type == 'md-lint'
         uses: actions/setup-node@v3
@@ -47,13 +42,13 @@ jobs:
         id: check_step
         run: |
           if [[ "${{ matrix.check_type }}" == "spellcheck" ]]; then
-            ./scripts/check-doc-aspell
+            yarn check-spelling
           exit_code=$?
           elif [[ "${{ matrix.check_type }}" == "kbcheck" ]]; then
-            ./scripts/knowledgebase-checker/knowledgebase_article_checker.py --kb-dir="knowledgebase"
+            yarn check-kb
           exit_code=$?
           elif [[ "${{ matrix.check_type }}" == "md-lint" ]]; then
-            yarn markdownlint-cli2 --config ./scripts/.markdownlint-cli2.yaml 'docs/**/*.md'
+            yarn check-markdown
           exit_code=$?
           fi
           

README.md

@@ -110,6 +110,12 @@ We recommend to install rsync in order to only copy what is needed, however the
 
 Running `yarn copy-clickhouse-repo-docs` without any arguments will pull in the latest docs changes from github.
 
+To check spelling and markdown is correct locally run:
+
+```bash
+yarn check-style
+```
+
 ### Notes {#notes}
 
 Here are some things to keep in mind when building a local copy of the ClickHouse docs site.
@@ -134,7 +140,13 @@ Check out the GitHub docs for a refresher on [how to create a pull request](http
 
 ### Style guidelines
 
-For documentation style guidelines, see ["Style guide"](/contribute/style-guide.md).
+For documentation style guidelines, see ["Style guide"](/contribute/style-guide.md). 
+
+To check spelling and markdown is correct locally run:
+
+```bash
+yarn check-style
+```
 
 ### Generating documentation from source code