We welcome contributions to [Project Name]! This document outlines the process for contributing to this project and how to get started.
- Fork the repository on GitHub.
- Clone your fork locally:
git clone https://github.com/nguyenvanduocit/epubtrans.git
- Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-name
- Ensure you have Go installed (version X.X or higher).
- Install any necessary dependencies:
go mod tidy
- Make your changes in your feature branch.
- Add or update tests as necessary.
- Ensure all tests pass:
go test ./...
- Run
gofmt
to ensure your code follows Go's formatting standards:gofmt -s -w .
- Commit your changes with a clear and descriptive commit message:
git commit -m "Add feature X" -m "This feature does Y and Z"
- Push your changes to your fork:
git push origin feature/your-feature-name
- Go to the original repository on GitHub.
- Click the "New pull request" button.
- Select your feature branch from your fork.
- Fill out the pull request template with all relevant information.
- Submit the pull request.
- Maintainers will review your pull request.
- They may ask for changes or clarifications.
- Make any requested changes in your feature branch and push the changes.
- Once approved, a maintainer will merge your pull request.
- Follow Go's official Code Review Comments.
- Write clear, readable, and maintainable code.
- Document your code using Go's standard commenting practices.
- Use the GitHub issue tracker to report bugs.
- Clearly describe the issue, including steps to reproduce.
- Include your Go version and operating system.
Thank you for contributing to Epubtrans