You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Hey Everyone!

I will be mentioning my ideas here for the documentation task force.

Initial Ideas :

GitHub templates and best practices :

  1. Creating a standard pull request template for the GitHub repository. 
  2. Using automation for closing the issue and PR.
  3. Mentioning coding guidelines 

Project templates and best practices :

A standard documentation template for all projects should be there. The template should include the following: 

  1. Purpose of the project so that users can understand what the project is about, enhancing user experience.
  2. Describe how to use the project, the mechanism, and the functionalities of various features. Make the reader understand the technology, before using it. Gives instructions on how to do the specific task. It consists of steps that need to be followed.
  3. Provide relevant links, code snippets, algorithms, images, graphics, flow charts, user flow, etc.
  4. Feedback from users 
  5. Conclusion and people to contact for more information (maintainers, project mentor)


Resources:

https://github.com/devspace/awesome-github-templates



    

         


  • No labels