DRAFT: This doc is draft. See https://help.github.com/en/articles/setting-guidelines-for-repository-contributors
ASP.NET Boilerplate is an open source and community driven project. This guide is aims to help anyone wants to contribute to the project.
You can always send pull requests to the GitHub repository.
- Clone the ASP.NET Boilerplate repository from GitHub.
- Make the required changes.
- Send a pull request.
Before making any change, please discuss it on the GitHub issues page. So that, other developers will not work on the same issue and your PR will have a better chance to be accepted.
You may want to fix a known bug or work on a planned enhancement. See the issue list on GitHub.
If you have a feature idea for the framework or modules, create an issue on GitHub or attend to an existing discussion. Then you can implement it if it's embraced by the community.
You may want to improve the documentation. If so, follow these steps:
- Clone the ABP repository from GitHub.
- Documents are located in /aspnetboilerplate/doc folder.
- Modify the documents and send pull request
- If you would like to add a new document, you need to add it to the navigation document as well. Navigation document is located in doc/WebSite/Navigation.md.
ASP.NET Boilerplate framework has a localization system. Localization resources are located in Abp\Localization\Sources\AbpXmlSource. You can add a new translation or update existing ones. To add missing translation, see this example pull request
The framework has pre-build modules, you can also add a new module. Abp.Dapper is a contributed module. You can check Abp.Dapper module to make your own.
TODO: May be added step by step module development guide.
If you would like to write tutorials or blog posts for ASP.NET Boilerplate, please let us know (by creating a GitHub issue](https://github.com/aspnetboilerplate/aspnetboilerplate/issues), so we may add a link to your tutorial/post in the official documentation and we announce it on the official Twitter account.
If you would like to report a bug, please create an issue on the GitHub repository
GitHub issues are for bug reports, feature requests and other discussions about the framework.
If you're creating a bug/problem report, please include followings:
* Your Abp package version.
* Your base framework: .Net Framework or .Net Core.
* Exception message and stack trace if available.
* Steps needed to reproduce the problem.Only English!
You can use StackOverflow for your questions about using the framework, templates and samples:
https://stackoverflow.com/questions/tagged/aspnetboilerplate
Use aspnetboilerplate tag in your questions.