-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
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
Minor documentation fixes #322
Conversation
Thanks, this is awesome! I wrote you some comments to the commit itself but don’t see them in the PR ;-/ |
docs/Documenting.md
Outdated
@@ -1,16 +1,18 @@ | |||
# Documenting components | |||
|
|||
Styleguidist generates documentation from three sources: | |||
Styleguidist generates documentation for your components based on the comments in your source code, propTypes declarations and your Readme files. |
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.
Not sure about “your Readme files”. It’s more like a Styleguidist requirement ;-)
docs/Documenting.md
Outdated
## PropTypes and component description in the source code | ||
## Code comments and propTypes | ||
|
||
Styleguidist will display a JSDoc comment block at your component's class declaration. Also, it will pick up props that your component uses from propTypes declarations and display them in a nice table together with their defaults, accepted values (where appropriate) and accompanying JSDoc comments. |
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.
- Not only classes, functional components too.
- “props that your component uses” → “your component‘s props”?
- “nice” → “”.
Codecov Report
@@ Coverage Diff @@
## next #322 +/- ##
=======================================
Coverage 91.84% 91.84%
=======================================
Files 70 70
Lines 956 956
Branches 193 193
=======================================
Hits 878 878
Misses 78 78 Continue to review full report at Codecov.
|
fd34503
to
a43e9b9
Compare
🔥 |
This PR cleans up grammar and fixes a few typos in the docs.