Skip to content

Commit 6e2a17f

Browse files
authored
Update How-to-Use-Issues-in-Arctos.markdown
1 parent 717f096 commit 6e2a17f

File tree

1 file changed

+7
-10
lines changed

1 file changed

+7
-10
lines changed

_how_to/How-to-Use-Issues-in-Arctos.markdown

+7-10
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
---
22
title: How To Github - Create and Manage Github Issues for Arctos
33
layout: default_toc
4-
author: Dusty McDonald, Teresa J. Mayfield-Meyer
5-
date: 2016-06-06, 2023-07-26
4+
author: DLM
65
---
76

87
# How To Github: Create and Manage Github Issues for Arctos
@@ -53,17 +52,15 @@ to assign the new Issue a number. Be clear and verbose in explaining the need an
5352

5453
Use these pointers to streamline getting the solution you need.
5554

56-
* Tell us your overall goals. We can help only if we understand what you're trying to accomplish in sufficient detail. This will often involve an explanation of why the goal is important - "we want to record *_data_* because researchers need it for *_purpose_*."
57-
58-
* Tell us *what* you hope to accomplish, not (only) *how* you hope to do so. We will get to how, but beginning the conversation with something like a [Product requirements document](https://en.wikipedia.org/wiki/Product_requirements_document) will generally lead to more robust solutions and avoid [target fixation](https://en.wikipedia.org/wiki/Target_fixation).
59-
60-
* Use templates. We have templates for common tasks, they specify the most common information we need. (Issues regarding how to make them better are always welcome.)
61-
62-
* Include enough information for us to fully understand and replicate the problem or request. This includes but is not limited to
55+
* Tell us your overall goals or functional requirements. We can help only if we understand what you're trying to accomplish in sufficient detail. This will often involve an explanation of why the goal is important - "we want to record *_data_* because researchers need it for *_purpose_*."
56+
* Tell us *what* you hope to accomplish, not (only) *how* you hope to do so. We will get to how, but beginning the conversation with something like a [Product requirements document](https://en.wikipedia.org/wiki/Product_requirements_document) will generally lead to more robust solutions and avoid [target fixation](https://en.wikipedia.org/wiki/Target_fixation).
57+
* Include enough detail that someone with a solution to the problem - even a very unexpected one - might recognize the situation and offer help.
58+
* Include enough detail that someone with a similar problem - even if they might not describe it in the same way - could recognize the solution being offered.
59+
* Include enough information for us to fully understand and replicate the problem or request. This includes but is not limited to
6360
* Data as uploaded (ZIPped to attach)
6461
* URLs
6562
* Specific sequence of clicks to get to a point of interest
66-
* Copy-paste of error messages (particularly the ErrorID - a UUID like ``795B1D17-0461-4A03-B6DC1314448ED77F``)
63+
* Text (**not** images!) of error messages (particularly the ErrorID - a UUID like ``795B1D17-0461-4A03-B6DC1314448ED77F``)
6764
* Screenshots
6865
* Arctos usernames of involved persons
6966

0 commit comments

Comments
 (0)