docs: Remove the api docs sphinx project.

* This project was not being published anywhere. * The previous commit that adds openapi generation capabilities to the `docs/guides` replaces what this was doing.
eduNEXT · Jun 29, 2023 · 2626213 · 2626213
1 parent 56cad59
commit 2626213
Show file tree

Hide file tree

Showing 7 changed files with 3 additions and 386 deletions.
diff --git a/Makefile b/Makefile
@@ -1,5 +1,5 @@
 # Do things in edx-platform
-.PHONY: api-docs-sphinx api-docs base-requirements check-types clean \
+.PHONY: base-requirements check-types clean \
   compile-requirements detect_changed_source_translations dev-requirements \
   docker_auth docker_build docker_push docker_tag docs extract_translations \
   guides help lint-imports local-requirements pre-requirements pull \
@@ -25,22 +25,15 @@ clean: ## archive and delete most git-ignored files
 
 SWAGGER = docs/swagger.yaml
 
-docs: api-docs guides technical-docs ## build all the developer documentation for this repository
+docs: guides technical-docs ## build all the developer documentation for this repository
 
 swagger: ## generate the swagger.yaml file
 	DJANGO_SETTINGS_MODULE=docs.docs_settings python manage.py lms generate_swagger --generator-class=edx_api_doc_tools.ApiSchemaGenerator -o $(SWAGGER)
 
-api-docs-sphinx: swagger	## generate the sphinx source files for api-docs
-	rm -f docs/api/gen/*
-	python docs/sw2sphinxopenapi.py $(SWAGGER) docs/api/gen
-
-api-docs: api-docs-sphinx	## build the REST api docs
-	cd docs/api; make html
-
 technical-docs:  ## build the technical docs
 	$(MAKE) -C docs/technical html
 
-guides:	## build the developer guide docs
+guides:	swagger ## build the developer guide docs
 	cd docs/guides; make clean html
 
 extract_translations: ## extract localizable strings from sources

diff --git a/docs/api/.gitignore b/docs/api/.gitignore
diff --git a/docs/api/Makefile b/docs/api/Makefile
diff --git a/docs/api/__init__.py b/docs/api/__init__.py
diff --git a/docs/api/conf.py b/docs/api/conf.py
diff --git a/docs/api/index.rst b/docs/api/index.rst