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

Documentation of the website #25

Open
shubhank-saxena opened this issue Apr 14, 2020 · 7 comments
Open

Documentation of the website #25

shubhank-saxena opened this issue Apr 14, 2020 · 7 comments
Labels
documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers hacktoberfest

Comments

@shubhank-saxena
Copy link
Member

This is an open source project.
So we need to write a documentation explaining the following -

  1. Entire structure of the website
  2. Technologies used
  3. How to fork and develop (so that this website/project can be used by other communities). Make sure they do give due credits.
  4. How to deploy
@shubhank-saxena shubhank-saxena added documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers labels Apr 14, 2020
@animesh-007
Copy link
Collaborator

@shubhank-saxena I guess this issue is now solved by updated readme.md Only thing missing in readme is technologies used.

@priyanshsaxena24
Copy link

Hey is this issue still open? @jaskeerat789 would love to contribute.

@jaskeerat789
Copy link
Member

@deathzombie yes you can start working but make sure you register for hacktoberfest here since the issue is tagged as hacktoberfest

@jaskeerat789
Copy link
Member

@shubhank-saxena @jsparmani Please provide the task which are unfinished in documentation. make a checklist so that we can keep adding and checking stuff accordingly.

@jsparmani
Copy link
Member

jsparmani commented Oct 1, 2020

The documentation must have these topics:

  • Full Repository structure, explaining the hierarchy if folders and clearly distinguishing on frontend and backend code
  • Details on Tech Stack, Libraries Used with links to their documentation.
  • Insight on How to Setup the Repo, already there in CONTRIBUTING.md, but must be mentioned distinctively.
  • Guidelines on Pre-Commit and Travis Builds (should have info about each test being carried by travis)
  • Fix to some common error messages and known bugs
  • Info about the Deployment Setup (Technologies used + procedure followed)
  • Some common checklists/rules to take care of before committing or opening a PR

@jaskeerat789 @deathzombie I think following points are expected to be put up in the documentation. It can be good if we can have docs in an interactive format hosted at something like docs.dsctiet.tech or something, just like docs of some libraries or projects.

@shubhank-saxena Please suggest if there is any discrepancy in above list or if it misses some points.

@Subhamjain02
Copy link

Hey I would like to contribute

@jaskeerat789
Copy link
Member

Feel free to work on it and open a PR @Subhamjain02

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers hacktoberfest
Projects
None yet
Development

No branches or pull requests

6 participants