Project READMEs
Closed this issue ยท 8 comments
Add READMEs to each of the plugins/packages so they show up in the npm docs.
Most of the packages don't have any README.md
files in them, so when they get published to npm
, no docs show up.
There is some documentation for the plugins
that can serve as a starting point which is created from here
Ideally, the docs served on github-pages would match that of the README
's in each project, and would simply pull them in via a build-step before publishing the docs.
I can start on this. ๐
I am new to open source . please assign this on my name .
@adierkens
Hey,
I want to contribute on this issue.
Thanks for the interest. No need to comment first, feel free to just open up a PR with the changes
Hi there! I did some research about your last requirement:
Ideally, the docs served on github-pages would match that of the README's in each project, and would simply pull them in via a build-step before publishing the docs.
It looks like since you have gh-pages sourcing your documentation site, it only reads from the /docs folder and there isn't a way to intercept this. If you want all the readme's to be synced with the contents of the /docs folder, I think you have to manually go in to update them. (I could be wrong but this is what I've found online).
I was thinking of more of a build step that would copy each projects README into docs before publishing to gh-pages
Apologies for the simple question. I'm extremely new to GitHub, but would love to contribute to this issue. Is there a specific location you would prefer the README files to go into? I see that there are several README files in this plugins folder - is this where we should put them? Or (and/or) would you like us to add the README files directly to each package folder that is currently missing a README file (e.g., this package folder)? Thanks in advance, can't wait to participate in tonight's Hacktoberfest event.
๐ Issue was released in v0.0.8 ๐