-
Notifications
You must be signed in to change notification settings - Fork 890
docs: applications and authorization #5477
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
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- What quality level of documentation do we want to achieve? (description:
none
vs.DisplayName is the displayed name
)
Instead of none
, we could omit the text entirely (empty). I think it's fine not to document all obvious things for now. But ultimately I'd like for us to have very good coverage in codersdk
/API docs with explanations for most fields.
Thanks for the review, @mafredri! All comments addressed. It's interesting that we can continuously improve the rendering procedure to achieve better results! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice work!
It's interesting that we can continuously improve the rendering procedure to achieve better results!
I agree! It's nice to have bite-sized pieces, easier to catch oddities. 😄
Related: #3522
Changes:
Applications
,Authorization
@Description
)@Consume
with@Accept
Question:
* What quality level of documentation do we want to achieve? (description:Fix:none
vs.DisplayName is the displayed name
)s/none//g