Skip to content

Commit

Permalink
Spelling/grammar changes to Strategy doc (#126)
Browse files Browse the repository at this point in the history
* Create 0000-data-citation-plan.md

Initial draft.

* Tidy up prior to first review

* Rephrased Summary

Resolve comment on scientific publications.

* Revised Summary

Adopted Laura's alternative suggestion for scientific publications.

* Updated Phase 1

Explicitly state "stable non-versioned project URL".
Add redirect page for re-ingested projects.
Do not require a DOI for Phase 1.

* Update Phase 2

Specific that specific versions of projects are citable.
Add requirement for a DOI.

* Update Phase 3

Users can create versioned collections of data that are citable via a DOI.

* Update external DOI website

Add "may DOI resolve to an external website?" to Unresolved Questions.

* Clarify meaning of DOI repositories

* Minor updates to DOI section

* Added Acceptance Criteria

* Stable URLs for projects only

Stable URLs are for projects only.
Separate citation links are not provided for bundles or files within a project.

* Updated Unresolved Questions

* Clarify "Release View" question

Clarify the desirable functionality of the Data Browser providing a view of a particular Data Release and allowing further faceted searches within that view.

* Minor grammar fixes

* Added Shepherd

* Updates rarely affect primary data

* Clarify decision process for DOI assigning entity

* Add summary titles to the 3 phases

* Clarify use of matrix output files

* Update User Stories and Acceptance Criteria

Add a Data Operations team User Story.
Update the Acceptance Criteria for Stories #5 and #6 accordingly.

* Clarify Ingest DOI update suggestion

* Delete unused optional sections

* Remove unnecessary implementation note

* Change Data Release to Data Distribution

* Define Authorized User

* Clarify "cited data" in Phase 2

* Remove dependencies on Data Distribution features

* Remove all references to Data Dsitribution

* Spelling corrections

* Approved as rfc14

* Formatting updates

Use U.S. English spellings.
Fix minor formatting errors.
  • Loading branch information
theathorn committed Nov 4, 2019
1 parent 9183a74 commit 4c640ea
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions strategy/specific-aims.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

**Create a data resource that maximizes the value and use of Human Cell Atlas data across the scientific community.**

1. Collect all data considered suitable towards building the Human Cell Atlas into the DCP, ensure it is organised according to FAIR principles, and ensure it meets desired standards of QC
1. Collect all data considered suitable towards building the Human Cell Atlas into the DCP, ensure it is organized according to FAIR principles, and ensure it meets desired standards of QC
2. Encourage labs to adopt and incorporate HCA standards into their data generation practices, e.g. by recording protocols in protocols.io and registering project metadata as soon as a project is started, to avoid “lossy” conversions
3. Provide the means, and a standard policy, for using and citing HCA data (for example by providing stable accession numbers or DOIs) that encourages data provenance, reproducibility, and increases exposure of DCP resources

Expand All @@ -16,9 +16,9 @@ Read more about [measuring the impact](./measuring-impact.md#aim-1) of this aim.

**Provide researchers access to data that will enable the Human Cell Atlas to answer fundamental questions in all aspects of biology.**

1. Provide access to useable data (raw, processed and analysed) with informative metadata via APIs and a website-based user interface
1. Provide access to useable data (raw, processed and analyzed) with informative metadata via APIs and a website-based user interface
2. Ensure an intuitive and consistent experience whilst accessing DCP data and metadata, either via APIs or user interfaces
3. Deliver search capability and summary information over DCP datasets, via APIs or user interfaces, that are centred on the needs of researchers who will draft tissue specific atlases and the Human Cell Atlas
3. Deliver search capability and summary information over DCP datasets, via APIs or user interfaces, that are centered on the needs of researchers who will draft tissue specific atlases and the Human Cell Atlas

Read more about [measuring the impact](./measuring-impact.md#aim-2) of this aim.

Expand All @@ -28,9 +28,9 @@ Read more about [measuring the impact](./measuring-impact.md#aim-2) of this aim.

1. Deliver regular releases of all data in the DCP that passes latest quality controls
2. Provide regular releases of specific data subsets in the DCP that can be used to reproduce analyses, including (for example) the drafting of tissue specific atlases
3. Regularly migrate experimental design descriptions (including metadata) to the latest standards, and flag non-conformant data for manual review. Exclude non-conformant it from future releases until it has been curated
4. Periodically reprocess and reanalyse data using the latest pipelines in the DCP
Provide access to previous DCP releases via APIs and user interfaces that present the same experience as the current versions
3. Regularly migrate experimental design descriptions (including metadata) to the latest standards, and flag non-conformant data for manual review. Exclude non-conformant data from future releases until it has been curated
4. Periodically reprocess and reanalyze data using the latest pipelines in the DCP
5. Provide access to previous DCP releases via APIs and user interfaces that present the same experience as the current versions

Read more about [measuring the impact](./measuring-impact.md#aim-3) of this aim.

Expand All @@ -39,7 +39,7 @@ Read more about [measuring the impact](./measuring-impact.md#aim-3) of this aim.
**Build alignment amongst the Human Cell Atlas community around a core set of computational methods and analyses.**

1. Provide reports on the most commonly used technologies based on relative quantities of data in the DCP, allowing the community to evaluate whether the data in the DCP is reflective of trends and technology choices in the community at large
2. Focus on delivery of processing pipelines and analysis support for the technologies that are most commonly utilised by the Human Cell Atlas community
2. Focus on delivery of processing pipelines and analysis support for the technologies that are most commonly utilized by the Human Cell Atlas community
3. Deliver a core set of data processing pipelines and analysis methods that are endorsed by the analysis working group
4. Support community-contributed pipelines for data processing and analysis.

Expand All @@ -49,9 +49,9 @@ Read more about [measuring the impact](./measuring-impact.md#aim-4) of this aim.

**Create standards for the community to use to describe single cell experimental designs, including assay types, data and metadata.**

1. Characterise, describe and validate the set of known single cell experiment designs and ensure these are associated with measures of impact (e.g. QC scores, or description in a publication)
1. Characterize, describe and validate the set of known single cell experiment designs and ensure these are associated with measures of impact (e.g. QC scores, or description in a publication)
2. Support scientists to make direct comparisons of DCP data in order to identify the best methods and protocols for drafting the Human Cell Atlas
3. Define standards for describing experimental designs, biological materials, analysis methods and data files formats, focusing on the features that are known to be valuable when characterising cell types
3. Define standards for describing experimental designs, biological materials, analysis methods and data files formats, focusing on the features that are known to be valuable when characterizing cell types
4. Ensure DCP standards are interoperable with, or aligned to, established community standards outside of the DCP and the HCA wherever possible

Read more about [measuring the impact](./measuring-impact.md#aim-5) of this aim.

0 comments on commit 4c640ea

Please sign in to comment.