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

feat: route doc descriptions #322

Merged
merged 15 commits into from
Sep 15, 2022
Merged

feat: route doc descriptions #322

merged 15 commits into from
Sep 15, 2022

Conversation

ChrisPdgn
Copy link
Contributor

@ChrisPdgn ChrisPdgn commented Sep 12, 2022

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update
  • Refactor
  • Build-related changes
  • Other (please describe)

Does this PR introduce a breaking change?

  • Yes
  • No

The PR fulfills these requirements:

  • It's submitted to the main branch
  • When resolving a specific issue, it's referenced in the PR's description (e.g. fix #xxx, where "xxx" is the issue number)

@ChrisPdgn ChrisPdgn changed the title chore(storage): add route descriptions chore: add route descriptions to all modules and packages Sep 14, 2022
@ChrisPdgn ChrisPdgn marked this pull request as ready for review September 14, 2022 12:32
@ChrisPdgn ChrisPdgn requested review from kon14, kkopanidis, sdimitris and SotiriaSte and removed request for kon14 September 14, 2022 12:32
kon14
kon14 previously requested changes Sep 14, 2022
Copy link
Contributor

@kon14 kon14 left a comment

Choose a reason for hiding this comment

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

Remove explicit references to required params in descriptions (eg requiring only ...) as these can become outdated and are otherwise already documented for each route outside the description.

Remove the all part from getters (eg Returns all forms) as most of them can be queried, or at the very least paginated, based on other params etc.

modules/chat/src/routes/InvitationRoutes.ts Outdated Show resolved Hide resolved
modules/chat/src/routes/InvitationRoutes.ts Outdated Show resolved Hide resolved
modules/chat/src/routes/index.ts Outdated Show resolved Hide resolved
modules/database/src/admin/index.ts Outdated Show resolved Hide resolved
modules/database/src/admin/index.ts Outdated Show resolved Hide resolved
modules/email/src/admin/index.ts Outdated Show resolved Hide resolved
packages/admin/src/routes/ChangePasswordRoute.ts Outdated Show resolved Hide resolved
modules/authentication/src/handlers/local.ts Outdated Show resolved Hide resolved
@kon14 kon14 changed the title chore: add route descriptions to all modules and packages feat: route doc descriptions Sep 14, 2022
@kkopanidis kkopanidis merged commit 981643b into main Sep 15, 2022
@kkopanidis kkopanidis deleted the route-descriptions branch September 15, 2022 14:37
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.

None yet

3 participants