Move doc files from main repo into docs repo

[voetberg]

View issue rucio/rucio#7278 ; Removing check_rest_api_documentation from that repo and moving here as part of decommissioning of the docs test suite

[rdimaio]

Maybe we should say this to be explicit

Suggested change

	rucio_documentation/tools/check_rest_api_documentation.sh FILE
	[rucio documentation folder]/tools/check_rest_api_documentation.sh FILE

rucio_documentation is clear enough imo, but it might be interpreted as if we have an actual folder named rucio_documentation, whereas [rucio documentation folder] might be more easily interpreted as 'top-level Rucio documentation folder'

[voetberg]

If we're linking directly to the file anyways, is there any harm in going Full explicit and doing

Suggested change

	rucio_documentation/tools/check_rest_api_documentation.sh FILE
	[rucio/documentation](https://github.com/rucio/documentation)/tools/check_rest_api_documentation.sh FILE

?

[rdimaio]

I like the idea, but I feel that the / in rucio/documentation could be interpreted as being part of the path, so it might be confusing

[rdimaio]

what are the # type: ignore comments for?

[voetberg]

The python script checking action claims these packages don't exist and fails the build 😔

[rdimaio]

Maybe we could add them to the requirements instead - I guess they can be seen as part of the requirements for building the docs, so it makes sense that they'd need to be part of the requirements.txt file

  check_python_scripts:
    name: Check Python Scripts
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      - name: Install dependencies
        run: |
          pip install -r tools/requirements.txt
      - name: Run black
        run: |
          black --check .
      - name: Run isort
        run: |
          isort --profile black --filter-files --check .
      - name: Run flake8
        run: |
          flake8 --config tools/.flake8
      - name: MyPy
        run: |
          mypy --ignore-missing-imports .