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

DOCS: Make a README.md and Update Wiki #4

Open
7 of 23 tasks
ohbus opened this issue Jun 19, 2021 · 2 comments
Open
7 of 23 tasks

DOCS: Make a README.md and Update Wiki #4

ohbus opened this issue Jun 19, 2021 · 2 comments
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers help wanted Extra attention is needed

Comments

@ohbus
Copy link
Member

ohbus commented Jun 19, 2021

Please make an awesome README.md file

This is a Collated issue, this can be broken down into multiple small issues, the respective issue links for different tasks will be appended after the checklist.

This issue can be taken up by multiple assignees.

Take a Look at our Wiki section for inspiration
Most of the README sections will be referring to the Wiki section already

Goals

  • Provides a good overview of the project
  • Links to Wiki on how to get engaged
  • Improve Wiki section respectively for the necessary

Checklist for Wiki and README sections

  • Project Title
  • Dependencies / Technolgy Selection
  • Installation
  • Lombok Configuration
  • Project Configuration
  • Coding conventions
  • Milestones & versioning
  • API Endpoints Detailed Documentation with Response and Request bodies
  • How to TEST the API endpoints
  • Collaboration
  • Working with issues
  • Reviewing pull requests
  • Static analysis
  • IDE instructions
  • Roadmap
  • Team
  • Known issues
  • Getting help
  • Getting involved
  • Recognizing contributors (Planning on using allcontributors)

Feel free to add your own points and let us know that you have completed any task on the Wiki, after reviewing we will update the same for you.

@ohbus ohbus added documentation Improvements or additions to documentation help wanted Extra attention is needed good first issue Good for newcomers labels Jun 19, 2021
@championswimmer
Copy link

@ohbus let's add a README.md too, which has links to the discussion and to the wiki pages

People start from the README, go into Wiki for deeper details only.

@ohbus
Copy link
Member Author

ohbus commented Jul 27, 2021

@ohbus let's add a README.md too, which has links to the discussion and to the wiki pages

People start from the README, go into Wiki for deeper details only.

Working on it!

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 good first issue Good for newcomers help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

2 participants