Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[UserStory] Need documented characteristics of a district and associated metrics #89

Open
5 tasks done
jody opened this issue Nov 8, 2021 · 2 comments
Open
5 tasks done
Labels
documentation Improvements or additions to documentation E: 3 Effort: 3 Story-Points S: Significant Severity: Significant - in the mainline plan user story User Story

Comments

@jody
Copy link
Contributor

jody commented Nov 8, 2021

User Story

Essential components

  • Title describes the story
  • Stakeholder type is identified
  • Outcome is described
  • Rationale is explicit
  • Acceptance criteria are verifiable and from the perspective of the stakeholder

Story

As a stakeholder (all types)
I want definitions of relevant characteristics of districts and associated metrics to be documented
so that there is a common understanding of the domain and specific aspects addressed by the project.

Acceptance Criteria

  • Project documentation identifies characteristics of districts relevant to the project domain.
  • Project documentation defines the meaning of district characteristics and provides external references for those definitions.
  • Project documentation identifies and specifies metrics associated with the district characteristics.
  • At minimum, documentation is provided for the following relevant characteristics:
    • population equality
    • contiguity
    • compactness
    • shape regularity

Supporting Information

See also: #22 (comment)

References:
Congressional Redistricting Criteria and Considerations

Dependencies

Depends On

(Issues on which this story depends)

Dependents

(Issues dependent on this story)

@jody jody added user story User Story documentation Improvements or additions to documentation E: 3 Effort: 3 Story-Points S: Significant Severity: Significant - in the mainline plan labels Nov 8, 2021
@tdefo
Copy link

tdefo commented Nov 27, 2021

Horace, GitHub ID: halexan7, and I, GitHub ID: tdefo of MutliCoreDevs are taking a look at this one. It seems that this issue directly depends on issue #22 since to find continuity, we need the grid coordinates and results from generateDistricts().

@jody
Copy link
Contributor Author

jody commented Nov 28, 2021

Horace, GitHub ID: halexan7, and I, GitHub ID: tdefo of MutliCoreDevs are taking a look at this one.

Sounds great. Please keep us involved in the discussion and apprised of progress.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation E: 3 Effort: 3 Story-Points S: Significant Severity: Significant - in the mainline plan user story User Story
Projects
Development

No branches or pull requests

2 participants