Category:Update a Tracker Issue (Pathway)

From Foss2Serve
Revision as of 17:16, 7 February 2017 by Clif.kussmaul (Talk | contribs)
Jump to: navigation, search


The contributor will: study and attempt to update a tracker issue (e.g. a bug report or feature request) to identify missing information, provide additional information, or resolve the issue.

The contribution is: updated information about the issue, which could make it easier to address.

Prerequisites

Area The contributor must be able to:
Software Configuration
  • Run the program.
  • Possibly: Download and install the development environment.
Issue Tracker
  • Describe issue trackers and how they are used.
  • Access the issue tracker with appropriate permissions.
  • Read, create, and update issues in a tracker.
Community
  • Describe the community guidelines for management and triage of issues (bug reports and feature requests).

Pathway Steps, Outcomes, & Learning Activities

Follow the project’s policies and practices to complete the steps below.

Pathway Step Step Outcome Process Skills Focus Related Learning Activities
1. Select a tracker issue to update. For example:
  1. an issue identified by the HFOSS community as appropriate for students.
  2. an issue identified (and possibly assigned) by the instructor.
  3. an issue selected by the student.
You have selected an issue. Bug Selection
2. Study the issue details and identify aspects that could be clarified.
a. How could the issue's description be clarified?
i. for a bug report, it is clear what goes wrong, and how to reproduce it?
ii. for a feature request, it is clear what could be better, and how it might work?
b. How could the issue's impact be clarified?
i. How many users are affected?
ii. How important is it to these users?
c. How could the issue's scope be clarified?
i. What code, documentation, database, etc would be changed?
ii. How difficult will these changes be?
You have identified one or more aspects that could be clarified.
3. Choose an aspect and try to clarify it.
a. If the description is unclear:
i. Search for more details - was the issue discussed in IRC, forums, other issues, etc?
ii. Specify what is unclear and ask the reporter to clarify.
d. If the issue is a bug report, try to Verify a Bug.
e. If the issue is a feature request, try to
1. Read the bug report on the issue tracker.
i. If there is enough information to reproduce the bug. continue to step 2.
ii. Otherwise, use the issue tracker to ask the reporter for more information.
Exception: Couldn’t understand the report: ask the reporter for additional information using the issue tracker
Decision to proceed to the next step or a request for more information in the issue tracker.
2. Reproduce the bug
i. Run the program
ii. Follow the steps outlined in the bug report. If the steps cannot be followed, use the issue tracker to ask the reporter for clarification.
Exception: Procedure in bug report could not be followed: ask reporter for clarification using the issue tracker
iii. Observe the program’s behavior
Observation of program behavior or a request for more information in the issue tracker.

Reproduce a Bug Activity

3. Report results on the issue tracker Report posted to issue tracker.

Part of Reproduce a Bug Activity

Notes for Learning Activities Related to this Pathway

When creating activities:

  1. Use examples to demonstrate concepts to student.
  2. Use screen shots when possible.
  3. Prompt students to indicate the exact steps taken to replicate the bug.

This category currently contains no pages or media.

Personal tools
Namespaces
Variants
Actions
Events
Learning Resources
HFOSS Projects
Evaluation
Navigation
Toolbox