Thank you for considering contributing to Nexent! From code to docs to sharing your experience, every bit helps make Nexent better for everyone. It also helps us if you share Nexent with others, or simply ⭐️ the repo. Thanks a million! 💛 Let's build something amazing together! 🎉
In terms of licensing, please take a minute to read our short License and Contributor Agreement. The community also adheres to the code of conduct.
If you've discovered a bug, please let us know! Your keen eye helps us improve Nexent for all users.
Got a brilliant idea to enhance Nexent? We'd love to hear it! Share your vision with us.
Whether it's fixing a bug or adding a new feature, your code contributions are highly valued.
Great documentation is key to a great project. Help us make Nexent easier to use and understand.
Gitflow is a branching model for Git that provides a structured approach to software development. It defines specific branches for different purposes, like features, releases, and hotfixes, and outlines how they should interact. This helps streamline the development process, manage releases effectively, and facilitate collaboration.
- main: Represents the official release history and should always be deployable.
- develop: The main branch for ongoing development. It integrates new features and bug fixes from feature branches.
- feature branches: Used for developing new features. They branch off from develop and are merged back into it once the feature is complete.
- release branches: Created when a new release is about to be prepared. They allow for final testing and minor adjustments before merging into main and develop.
- hotfix branches: Used for fixing critical bugs in production. They branch off from main and are merged back into both main and develop.
- Structured workflow: Provides a clear and consistent process for managing different types of changes.
- Improved collaboration: Facilitates teamwork by defining clear roles for branches and how they should interact.
- Efficient releases: Streamlines the release process by isolating changes in dedicated branches and allowing for final testing.
- Reduced conflicts: By using feature branches and release branches, it helps minimize merge conflicts and makes it easier to resolve them.
For a visual overview, see the diagram above.
To help us quickly understand and fix the issue, please include:
- A clear title describing the bug.
- A detailed description of the issue, including steps to reproduce it.
- Any error messages or logs (if applicable).
- Expected behavior vs. actual behavior.
- Screenshots or screen recordings (if helpful).
For feature ideas, please provide:
- A clear title summarizing the feature.
- A detailed description of the feature and its benefits.
- Any relevant use cases or examples.
- Screenshots or mockups (if applicable).
Where to submit?
Open a new issue in our GitHub Issues section and select the appropriate template (Bug Report or Feature Request).
🍴 Fork the Nexent repository to your GitHub account.
📦 Clone your forked repository locally:
git clone https://github.com/ModelEngine-Group/nexent.git🌿 Create a new branch for your changes:
git checkout -b your-branch-name🧙♂️ Code like a wizard! Follow our Development Guide for setup instructions and coding standards. Ensure your changes are well-tested and documented.
📝 Commit with a clear and concise message following our commit message guidelines：
| Type | Icon | Description |
|---|---|---|
| Refactor | ♻️ | Code logic optimization without affecting functionality |
| Migration | 🚚 | Moving or migrating files or modules |
| Feature | ✨ | Adding new features or functionality |
| Bugfix | 🐛 | Fixing issues or bugs |
| Style | 🎨 | Improving code style, formatting without changing functionality |
| Chore | 🔨 | Updating tools, adjusting configurations |
| Docs | 📝 | Documentation changes only |
| Test | 🧪 | Add test cases or modify test cases |
Example commit message：
git commit -m "✨ add user authentication"
git commit -m "🐛 resolve login timeout issue"
git commit -m "📝 update API documentation"⚙️ Keep your fork updated with the latest changes from the main repository:
git remote add upstream https://github.com/ModelEngine-Group/nexent.git
git fetch upstream
git merge upstream/main🚀 Push your changes to your fork and open a PR in the main repository. Include:
- A clear title and description of your changes.
- A reference to the related issue (e.g.,
fixes #123). - Any additional context or screenshots.
Our team will review your PR and provide feedback. Collaboration makes the magic happen! ✨
When submitting changes to protected branches (like main), please note the following requirements：
-
Code Owner Review Required
- The PR will automatically request reviews from relevant code owners
- You cannot approve your own PR
- Code owner approval is mandatory
-
Multiple Approvals Required
- At least 2 approvals are required (including code owner approval)
- All CI checks must pass (lint, test, build, etc.)
-
Merge Process
- After submitting the PR, the system will automatically request code owner reviews
- At least two approvals (including code owner) are needed
- The "Merge" button will only become available after all requirements are met
-
Restrictions
- You cannot bypass reviews or force merge
- Direct pushes to protected branches are not allowed
- Self-approvals are not valid
Great documentation is a team effort! You can help by：
- Fixing typos or clarifying unclear sections.
- Adding missing documentation for features or setup steps.
- Translating docs into other languages.
To contribute：
- Follow the same steps as for code changes (fork, clone, branch, etc.).
- Edit the relevant documentation files (e.g.,
README.md,docs/). - Submit a PR with your improvements.
Stuck or have questions? We're here to help! Reach out to us via：
- GitHub Issues: Open an issue for discussion.
- Discord: Join our Nexent Community for real-time chat.
- Email: Drop us a line at wanmingchen1@huawei.com.
Thank you for being part of the Nexent journey. Your contributions make a real difference, and we can't wait to see what you create! Happy coding! 🚀🌈