Skip to content

Commit 35d0868

Browse files
authored
Merge pull request #231 from cfpb/ditch-swagger-docs
Remove outdated swagger-docs code and files
2 parents 3f9d45a + 1329fc4 commit 35d0868

22 files changed

+1
-239
lines changed

README.md

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -73,27 +73,7 @@ python manage.py runserver
7373

7474
## API Docs
7575

76-
[Documentation](https://cfpb.github.io/ccdb5-api/) for this repository is rendered via GitHub pages and [Swagger](https://swagger.io/docs/). They can be edited in the `docs/` directory, but to build or deploy them, you'll need to install docs requirements:
77-
78-
```
79-
pip install -r docs_requirements.txt
80-
```
81-
82-
You can then preview your changes locally by running `mkdocs serve` and then reviewing <http://127.0.0.1:8000/>
83-
84-
When your changes are ready, you can submit them as a normal pull request. After that, you can use this command to publish them:
85-
86-
```
87-
mkdocs gh-deploy --clean
88-
```
89-
90-
That pushes the necessary files to the `gh-pages` branch.
91-
92-
### Notes
93-
94-
- The `mkdocs gh-deploy` command will push any edits you've made locally to the `gh-pages` branch of the repository, whether you've committed them or not.
95-
- Mkdocs will create a "site" directory locally when you use either `build`, `serve` or `gh-deploy`. This is used to assemble assets to be pushed to the gh-pages branch, but the `site/` directory itself doesn't need to be under version control. It can be deleted after a deploy.
96-
76+
Original API documentation is available at https://cfpb.github.io/ccdb5-api/, but the docs are not being updated at this time.
9777

9878
## Running Tests
9979

ccdb5_api/settings.py

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,6 @@
2222
"django.contrib.staticfiles",
2323
"rest_framework",
2424
"complaint_search",
25-
"rest_framework_swagger",
2625
"flags",
2726
)
2827

@@ -60,20 +59,6 @@
6059

6160
WSGI_APPLICATION = "ccdb5_api.wsgi.application"
6261

63-
SWAGGER_SETTINGS = {
64-
"api_path": "/",
65-
"api_version": "0.1",
66-
"info": {
67-
"title": "Complaint Search Public API",
68-
"description": "This is the API for looking at Complaint Search Data",
69-
"version": "1.0.0",
70-
"termsOfService": "http://swagger.io/terms/",
71-
"contact": "[email protected]",
72-
"license": "Apache 2.0",
73-
"licenseUrl": "http://www.apache.org/licenses/LICENSE-2.0.html",
74-
},
75-
}
76-
7762
DATABASES = {
7863
"default": {
7964
"ENGINE": "django.db.backends.sqlite3",
-445 Bytes
Binary file not shown.
-1.11 KB
Binary file not shown.

docs/documentation/index.html

Lines changed: 0 additions & 79 deletions
This file was deleted.

docs/documentation/oauth2-redirect.html

Lines changed: 0 additions & 60 deletions
This file was deleted.

docs/documentation/swagger-initializer.js

Lines changed: 0 additions & 20 deletions
This file was deleted.

docs/documentation/swagger-ui-bundle.js

Lines changed: 0 additions & 3 deletions
This file was deleted.

docs/documentation/swagger-ui-bundle.js.map

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/documentation/swagger-ui-es-bundle-core.js

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)