Remove pdoc3 documentation

We don't want to use this tool or the documentation generated by it, due to its use of controversial imagery in the auto generated HTML.

Author: rwalton-arm

README.md

@@ -77,7 +77,6 @@ production release here:
 The follow described the major aspects of the project structure:
 
 - `azure-pipelines/` - CI configuration files for Azure Pipelines.
-- `docs/api` - Interface definition and usage documentation.
 - `src/mbed_tools/` - Python source files.
 - `news/` - Collection of news files for unreleased changes.
 - `tests/` - Unit and integration tests.

azure-pipelines/analyse-and-test.yml

@@ -3,7 +3,6 @@
 # This pipeline performs multiple actions to ensure the quality of the package:
 # - Performs static analysis and runs test on multiple Python versions and host platforms.
 # - Uploads test coverage to Code Climate
-# - Generates reference documentation
 
 # Trigger on a PR to master, beta or releases branches.
 pr:
@@ -112,27 +111,3 @@ stages:
  displayName: run tox -e $(tox.env)
 
  - template: steps/publish-code-coverage-results.yml
-
- - stage: DocBuild
- displayName: 'Build Documentation'
- dependsOn: []
- jobs:
- - job: Docs
- displayName: 'Build Documentation'
- pool:
- vmImage: 'ubuntu-latest'
-
- steps:
- - task: UsePythonVersion@0
- displayName: 'Use Python 3.7'
- inputs:
- versionSpec: '3.7'
-
- - script: |
- python -m pip install --upgrade tox
- tox -e generatedocs -- $(Build.Repository.LocalPath)/docs/api
- displayName: run tox -e generatedocs -- $(Build.Repository.LocalPath)/docs/api
-
- - publish: $(Build.Repository.LocalPath)/docs/api
- artifact: Documentation
- displayName: 'Publish documentation'

ci_scripts/prep-release

@@ -10,10 +10,8 @@ python ci_scripts/sync_board_database.py -vvv
 git add src/mbed_tools/targets/_internal/data/board_database_snapshot.json
 git add news/
 
-printf "Generating API docs and adding license headers\n"
-generate-docs --output_dir docs/api
+printf "Adding license headers\n"
 pre-commit run licenseheaders --all-files > /dev/null 2>&1 || true
-git add docs/api
 
 if ! NEW_VERSION=$(python ci_scripts/bump_version.py -vvv -n news/); then
  printf "No news files detected. Exiting.\n"
@@ -25,7 +23,7 @@ git update-index -q --ignore-submodules --refresh
 
 if ! git diff-index --cached --quiet HEAD --ignore-submodules --
 then
- printf "Found staged changes to commit after docs and target database update: $(git diff-index --cached --name-status --ignore-submodules HEAD)\n"
+ printf "Found staged changes to commit after target database update: $(git diff-index --cached --name-status --ignore-submodules HEAD)\n"
  # Towncrier will fail if it detects a news file that has not been committed to
  # the repository. So we need to ensure the news file generated by
  # sync_board_database.py was committed before running towncrier.