Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update standardization ingestion docs #567

Merged
merged 13 commits into from
May 12, 2023
Merged

Conversation

emmastephenson
Copy link
Collaborator

PULL REQUEST

Summary

Update the standardization ingestion API docs to include sample requests and responses, as well as some quick content updates.

Related Issue

Related to #488, but more PRs incoming to fix it. (I'm planning to split up the different routers to different PRs so the review burden isn't too bad)

Additional Information

Before:
Screenshot 2023-05-11 at 10 45 57 AM

After:
Screenshot 2023-05-11 at 10 45 29 AM

:param input: A dictionary with the schema specified by the StandardizePhonesInput
model.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Question for others - I know the :param and :return is standard for other Python documentation libraries, but doesn't seem to be recognized by OpenAPI. Given that our docs page has more detailed information about the requests and responses, any objection to me removing these?

@codecov
Copy link

codecov bot commented May 11, 2023

Codecov Report

Merging #567 (9d74b86) into main (6cbf6eb) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #567   +/-   ##
=======================================
  Coverage   96.49%   96.49%           
=======================================
  Files          45       45           
  Lines        2481     2481           
=======================================
  Hits         2394     2394           
  Misses         87       87           
Flag Coverage Δ
unit-tests 96.49% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Copy link
Member

@nickclyde nickclyde left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome, thanks Emma! 👍

@emmastephenson emmastephenson merged commit 6558653 into main May 12, 2023
@emmastephenson emmastephenson deleted the emma/488-ingestion-docs branch May 12, 2023 22:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants