-
Notifications
You must be signed in to change notification settings - Fork 73
README Template
Gary Wang edited this page May 13, 2022
·
5 revisions
A common template of the README.md
file for each project:
## Project Name
A short description of this project, so users could know what's this project is for, what does this project do. The description provided in the `debian/control` file could be a good start if you don't know what to provide.
### Dependencies
What packages need to be installed to use this project? You can also check the "Depends" provided in the `debian/control` file.
### Build dependencies
What packages need to be installed to be able to build this project from source?
## Installation
### Build from source code
Steps to build the project.
## Documentations
If any, link the documentation here. Please ensure the linked pages can be accessible from the public internet.
- Link 1
- Link 2
- ...
## Getting help
- [Official Forum](https://bbs.deepin.org/) for generic discussion and help.
- [Developer Center](https://github.com/linuxdeepin/developer-center) for BUG report and suggestions.
- [Wiki](https://wiki.deepin.org/)
## Getting involved
We encourage you to report issues and contribute changes
- [Contribution guide for developers](https://github.com/linuxdeepin/developer-center/wiki/Contribution-Guidelines-for-Developers-en) (English)
- [开发者代码贡献指南](https://github.com/linuxdeepin/developer-center/wiki/Contribution-Guidelines-for-Developers) (中文)
- [Translate for your language on Transifex](#) *please update to the actual Transifex link of this project*
## License
License description here. The license name is suggested to use the same one as [SPDX license identifier](https://spdx.org/licenses). Following is an example:
Deepin Example is licensed under [GPL-3.0-or-later](LICENSE)
This template is just for sample purposes. Individual projects could add extra sections to the template or remove existing sections if needed, and the texts need to be altered to match the actual state of the project.
Welcome to join the Deepin developer community. You could talk about even everything in the following channels:
-
GitHub developer center(recommended)
-
IRC #deepin channel(recommended)
- Google groups: deepin-users, deepin-developers