Skip to content

add more information and guideline for Contributing page.#762

Merged
kubeedge-bot merged 1 commit intokubeedge:masterfrom
fujitatomoya:issues/761
Feb 10, 2026
Merged

add more information and guideline for Contributing page.#762
kubeedge-bot merged 1 commit intokubeedge:masterfrom
fujitatomoya:issues/761

Conversation

@fujitatomoya
Copy link
Contributor

@fujitatomoya fujitatomoya commented Feb 6, 2026

  • Please check if the PR fulfills these requirements
  • The commit message follows our guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)

Which issue(s) this PR fixes:

Fixes #761

  • What kind of change does this PR introduce? (Bug fix, feature, docs update, ...)

add more description and guideline to navigate the users and developers how to make contribution to kubeedge implementation and documentation.

  • What is the current behavior? (You can also link to an open issue here)

Not much information there

  • What is the new behavior (if this is a feature change)?

Clear guideline to take the users and developers to the appropriate page.

  • Does this PR introduce a breaking change? (What changes might users need to make in their application due to this PR?)

No

  • Other information:

Signed-off-by: Tomoya Fujita <Tomoya.Fujita@sony.com>
@gemini-code-assist
Copy link

Summary of Changes

Hello @fujitatomoya, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly improves the KubeEdge project's Contributing documentation. It transforms a previously sparse guide into a comprehensive resource, offering clear pathways for new and experienced contributors to engage with both the codebase and the documentation. The update aims to reduce friction for potential contributors by providing explicit instructions and best practices.

Highlights

  • Enhanced Contribution Guidelines: The contribute.md file has been significantly expanded to provide clear, step-by-step instructions for both code and documentation contributions.
  • Detailed Code Contribution Workflow: New sections guide contributors through getting started (forking, cloning, building), finding issues (good first issue, help wanted), and the full contributor workflow (branching, commit messages, testing, PR submission).
  • Dedicated Documentation Contribution Guide: A specific section now details how to contribute to the KubeEdge documentation, including setting up the Docusaurus environment and submitting changes to the separate kubeedge/website repository.
  • Removal of Outdated Information: An old Golang version compatibility table has been removed, streamlining the content.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • docs/community/contribute.md
    • Replaced the "Preparation" section with detailed "Contribute to KubeEdge" and "Contribute to Documentation" sections.
    • Added a "Getting Started" subsection with instructions for forking, cloning, and reading the developer guide.
    • Introduced a "Find Something to Work On" subsection, suggesting issues labeled "good first issue" and "help wanted," as well as documentation improvements and bug reports.
    • Detailed the "Contributor Workflow" with steps for creating branches, writing commit messages, local testing commands (make verify, make lint, make test, make integrationtest), and pull request submission.
    • Created a "Contribute to Documentation" section, explaining the use of Docusaurus, how to set up the local environment, and the process for submitting documentation changes to the kubeedge/website repository.
    • Removed the outdated Golang version compatibility table.
Activity
  • The pull request was opened by fujitatomoya.
  • It addresses and fixes issue Lack of information for Contributing Page #761.
  • The primary purpose of this PR is to update documentation.
  • The author noted that the previous contributing guide lacked sufficient information, and this PR aims to provide clear guidelines for users and developers.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@kubeedge-bot kubeedge-bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Feb 6, 2026
Comment on lines -21 to -26
| | Golang 1.11 | Golang 1.12 | Golang 1.13 | Golang 1.14 |
|-------------------------|-----------------|-----------------|-----------------|-----------------|
| KubeEdge 1.2 | ✗ | ✓ | ✓ | ✓ |
| KubeEdge 1.3 | ✗ | ✓ | ✓ | ✓ |
| KubeEdge 1.4 | ✗ | ✗ | ✗ | ✓ |
| KubeEdge HEAD (master) | ✗ | ✗ | ✗ | ✓ |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i guess this is toooooo old and out dated, so that we can remove this entire section from here. (for along time, nobody has complained about this. that said, it is safe to remove.)

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request significantly improves the contributor guide by adding detailed instructions for contributing to both the KubeEdge codebase and its documentation. The new structure is clear and provides valuable information for new contributors. I've left a couple of comments to improve the accuracy of the provided commands and contribution process details. Overall, this is a great enhancement to the project's documentation.

4. **Test your changes** locally before submitting:
```bash
make verify # Run verification checks
make lint # Run linting

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The make lint command is not mentioned in the Developer Guide, which is referenced as the source for building and testing. This might cause confusion or errors for new contributors if the lint make target doesn't exist. Please consider removing this command to align with the developer guide, or update the guide to include it if it's a valid and recommended step.


5. **Push to your fork** and create a pull request to `kubeedge/kubeedge`

6. **Address review feedback** - PRs require approval from two maintainers

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The Community Membership guide indicates that Approvers review and approve contributions, while Maintainers typically have merge rights. Specifying maintainers here could be inaccurate. To align with the defined community roles, it would be better to state that approvals are needed from approvers.

Suggested change
6. **Address review feedback** - PRs require approval from two maintainers
6. **Address review feedback** - PRs require approval from two approvers

Copy link
Collaborator

@Shelley-BaoYue Shelley-BaoYue left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good content for new contributors! 👍
/lgtm
/approve

@kubeedge-bot kubeedge-bot added the lgtm Indicates that a PR is ready to be merged. label Feb 10, 2026
@kubeedge-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Shelley-BaoYue

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubeedge-bot kubeedge-bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 10, 2026
@kubeedge-bot kubeedge-bot merged commit 0881d28 into kubeedge:master Feb 10, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Lack of information for Contributing Page

3 participants