Working with issues in SourceCraft

Issues is a tool for tracking bugs, improvements, and new feature requests within a project. In an issue, you can start a discussion in comments, set the job status, priority, and responsible employee.

Joining a discussion on an issue

You can use issues to maintain user activity in a project. Users may vote for an issue, discuss problems or ideas in comments, share their suggestions, and ask for clarifications.

They can use reactions, e.g., likes, dislikes, and other emojis, to acknowledge a relevant or helpful comment. Users can mention each other in a message with the @ symbol and add links to other issues, milestones, and pull requests to group related discussions and resolve issues faster.

SourceCraft supports updating issue pages in real time. You do not need to refresh the page manually to see new comments, reactions, and other changes.

Viewing an issue

  1. Open the SourceCraft home page.

  2. On the Home tab, navigate to Repositories.

    To view an issue in another user's repository, navigate to Repositories on the Discover tab.

  3. Select the repository with the issue you want to join a discussion on.

  4. Under Plan on the repository page, go to Issues.

    Note

    The issue list page supports the following filters:

    • Status
    • Priority
    • Assignee
    • Author
    • Labels
    • Milestone
    • Title

    You can sort issues by the following parameters:

    • Date created
    • Date updated
    • Votes
  5. Select the issue you want to join a discussion on.

Voting for an issue

In the top-right corner of the issue page, click Vote.

You can revoke your vote at any time by clicking the same button.

Leaving a comment

On the issue page under Activity, enter your comment and click Comment.

When commenting, you can use Yandex Flavored Markdown, attach files, add emojis, and mention users with @.

To edit your comment, click in its top-right corner and select Edit.

To delete your comment, click in its top-right corner and select Delete.

Replying to a user

  1. In the top-right corner of the comment, click .
  2. Type your reply in the field that appears and click Comment.

Reacting to a comment

In the top-right corner of the comment, click and select an emoji.

Subscribing to notifications for an issue

To stay updated on new comments, reactions, and other events, subscribe to notifications for the issue. You will be getting these at the email linked to your account.

You will get issue notifications by default only if you are mentioned in a comment with @.

To subscribe to all issue notifications, click in the top-right corner of the issue page and select Subscribe.

To unsubscribe from all issue notifications, click in the top-right corner of the issue page and select Unsubscribe.

Editing an issue

  1. Open the SourceCraft home page.

  2. On the Home tab, navigate to Repositories.

  3. Select the repository you want to edit an issue in.

  4. Under Plan on the repository page, go to Issues.

    Note

    The issue list page supports the following filters:

    • Status
    • Priority
    • Assignee
    • Author
    • Labels
    • Milestone
    • Title

    You can sort issues by the following parameters:

    • Date created
    • Date updated
    • Votes
  5. Select the issue you want to edit.

  6. Edit its settings:

    • Enter a name for the issue.

    • Optionally, provide a detailed description of the issue or an idea for a new feature.

    • Optionally, attach additional files.

    • Under Priority, set priority:

      • Trivial: Trivial
      • Minor: Minor
      • Normal: Regular
      • Critical: Critical
      • Blocker: Blocker
    • Under Visibility, select issue access type:

      • Private: The issue can be accessed only by you.

      • Public: The issue can be accessed by any user with access to the repository.

        Note

        You can change the access level at any time.

    • Optionally, under Assignee, select the user responsible for the issue.

    • Optionally, under Labels, select the labels for the issue.

      You can select existing labels from the list or create a new one.

      To set the label color, click it and select the color from the drop-down list.

    • Optionally, under Milestone, select a milestone to link the issue with.

  7. To link the issue to other issues, click Link issue.

  8. To link the issue to pull requests, click Link pull request.

See also