Issues and Project Management

Details
Category: MokoGIT
  • Applicable Software: MokoGitea
  • Applicable Version: N/A

Using Issues

MokoGitea's built-in issue tracker helps you report bugs, request features, and manage tasks within each repository.

Creating an Issue

  1. Navigate to your repository and click the Issues tab.
  2. Click New Issue.
  3. Enter a descriptive Title and detailed Description (Markdown is supported).
  4. Optionally assign Labels, a Milestone, and an Assignee.
  5. Click Submit New Issue.

Labels

Labels help categorize issues (e.g., bug, enhancement, documentation). Create and manage labels under Issues → Labels. Use colors and descriptions to keep your team aligned.

Milestones

Milestones group related issues into a release or sprint. Create milestones under Issues → Milestones with a title, description, and optional due date. Track progress via the milestone's completion percentage.

Assigning Issues

Assign issues to team members to clarify ownership. You can assign multiple people to a single issue if collaboration is needed.

Project Boards

MokoGitea supports Kanban-style project boards for visual task management.

  1. Go to the Projects tab in your repository (or organization).
  2. Click New Project and give it a name.
  3. Add columns like To Do, In Progress, and Done.
  4. Drag and drop issues between columns as work progresses.

Linking Issues to Pull Requests

Reference an issue in a pull request or commit message using #issue-number (e.g., Fixes #42). When the pull request is merged, the linked issue will automatically close.

Tips

  • Use issue templates (stored in .gitea/ISSUE_TEMPLATE/) to standardize bug reports and feature requests.
  • Subscribe to issues to receive notifications about updates.
  • Use @mentions to notify specific team members in comments.
Hits: 65