ZeroOctave-Javascript-Projects icon indicating copy to clipboard operation
ZeroOctave-Javascript-Projects copied to clipboard

Add Guides/Docs to existing projects [SSOC]

Open Krishna-bansall opened this issue 2 years ago • 5 comments

Is your feature request related to a problem? Please describe. Well the motive of this project is to teach people about web dev although this project just contains these projects without any sort of guide which is useless to a newbie

Describe the solution you'd like Add Readme Guides to all projects and render the readme on public site using something like Jekyll

Describe alternatives you've considered We could've added comments to the code but that would way more work and less intuitive for users

Additional context Whenever user clicks on the project (on public site) instead of redirecting to project itself user should be redirected to the readme

Steps Followed✅

Check the box with [x] If you followed all the steps.

  • [x] Is your feature request related to a problem? Please describe.
  • [x] Describe the solution you'd like
  • [x] Describe alternatives you've considered
  • [x] Additional context

Code of Conduct✅

Krishna-bansall avatar Aug 05 '22 05:08 Krishna-bansall

Thanks for raising the issue wait for it to get assigned.

github-actions[bot] avatar Aug 05 '22 05:08 github-actions[bot]

Great Suggestion. Explain how are you planning to implement in previous projects. Adding Readme in new projects will be easy.

Astrodevil avatar Aug 05 '22 05:08 Astrodevil

Well documenting all the projects would be almost impossible

But we can document 10-20 good projects because honestly some of the projects are pretty bad & not worth documenting

I can build the md rendering functionality myself and build some templates so that we can open issues with beginner friendly tags so people coming from ssoc can get started by documenting

Krishna-bansall avatar Aug 05 '22 06:08 Krishna-bansall

Cool, It Will be better if all readme will be put in a docs folder inside assets to avoid mixing. And it will be fetched on main page from there.

And we can also ask new project contributors to add proper readme from now onwards.

Go ahead👍

Astrodevil avatar Aug 06 '22 05:08 Astrodevil

Ok sure I'll create a new project documentation guide & a guide for documentation of old ones

Ok so you assign this issue to me

I'll pick some projects that should be good to document first and should i raise multiple issues for those? So that you can label them as low hanging fruits?

Krishna-bansall avatar Aug 06 '22 10:08 Krishna-bansall