Skip to content

Update faqs 20250922 Geographic metadata FAQ & fix typos - #14

Merged
DeondeJager merged 8 commits into
masterfrom
Update-FAQs-20250922
Aug 10, 2026
Merged

Update faqs 20250922 Geographic metadata FAQ & fix typos#14
DeondeJager merged 8 commits into
masterfrom
Update-FAQs-20250922

Conversation

@DeondeJager

Copy link
Copy Markdown
Contributor

No description provided.

@DeondeJager
DeondeJager requested a review from jfy133 September 22, 2025 09:58

@jfy133 jfy133 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good as first pass! Mostly maybe consider removing a bit of the detail that is already in the term itself, and give examples with the aDNA specific implementation

Comment thread docs/documentation/user-documentation/faq.md
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md
Updated geography FAQ by removing some details and adding an example.
@DeondeJager
DeondeJager requested a review from jfy133 January 12, 2026 10:11

@jfy133 jfy133 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional minor comments

_TODO_

## How to fill in geographic metadata
There are two primary ways of providing the geographic location of a sample with existing MIxS terms: `Geographic location (latitude and longitude)` and `Geographic location (country and/or sea,region)`. Both of these are required fields and we suggest filling in at both terms with as precise information as possible. There is also a third term that is specific to the ancient DNA MInAS checklist, `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
There are two primary ways of providing the geographic location of a sample with existing MIxS terms: `Geographic location (latitude and longitude)` and `Geographic location (country and/or sea,region)`. Both of these are required fields and we suggest filling in at both terms with as precise information as possible. There is also a third term that is specific to the ancient DNA MInAS checklist, `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.
There are two primary ways of providing the geographic location of a sample with existing MIxS terms: `Geographic location (latitude and longitude)` and `Geographic location (country and/or sea,region)`.
Both of these are required fields and we suggest filling in at both terms with as precise information as possible.
There is also a third term that is specific to the ancient DNA MInAS checklist, `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.


_TODO_
- **Geographic location (latitude and longitude)**:
- The MIxS term [`Geographic location (latitude and longitude)`](https://genomicsstandardsconsortium.github.io/mixs/0000009/) is used to record the coordinates in decimal degrees, limited to 8 decimal points and separated by a single whitespace (e.g. `-39.27774231 175.61028236`). While limited to 8 decimal points, you will rarely need such precision, unless you've extracted DNA from a [specific grain of sand](https://xkcd.com/2170/). See [here](https://en.wikipedia.org/wiki/Decimal_degrees) to guide your decision on the appropriate level of precision to report.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The grain of sand thing should maybe go as a footnote using [^1] and [^1]: description syntax

Need to rewrite this FAQ once site location terms have been added (see MIxS-MInAS/extension-ancient#45 (comment))
Comment thread docs/documentation/user-documentation/faq.md Outdated

@jfy133 jfy133 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm still finding this section a bit confusing to follow...

The way I would structure it put it is something more like:

  1. MIxS and MInAS has two ways of representing geographical information about a sample
  2. These two ways cover where the sample normally is based at the time of sampling (e.g. museum), and where the original geographical 'source' the sample was from (the original burial site, or natural location)
  3. For the former, use the MIxS terms XYZ... (with specific guidance for each term, e.g. lat_lon precision)
  4. For the latter, use the MInAS terms orig_... (with specific guidance for each term, e.g. lat_lon precision)
  5. If you directly sampled the ancient material at the burial location, the information will be the same

General thing: try to avoid bullet point lists when you have long text

And I guess now we have the new terms you can add more examples too :)

Comment thread docs/documentation/user-documentation/faq.md
Comment on lines +27 to +28
These fields are used to record the museum location if the specimen originated from a museum, because this is where the sampling with intention to sequence occurred (see the ENA [FAQs](https://ena-docs.readthedocs.io/en/latest/faq/spatiotemporal-metadata.html#i-have-an-ancient-dna-sample-how-do-i-provide-the-spatiotemporal-information-for-my-sample-which-location-and-date-should-be-reported)).
If the specimen was excavated from an archaeological/palaeontlogical site with the intention to sequence (without first going via a museum) then the site information goes in the above terms.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would flip this:

  1. By default we assume samples were sampled directly from the environment/burial context
  2. How IF the samples have been removed from their natural environment/burial context and are stored and/or were sampled from a collection or archive, the ENA guidance is that these geographic information terms should represent the collection or archive.

i.e., the collections is the exception not the rule

Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
- _insert site_lat_lon tarm_
- `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.

- **Geographic location (latitude and longitude)**:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK I'm confused by the order again 😅

Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
Comment thread docs/documentation/user-documentation/faq.md Outdated
- **Geographic location (country and/or sea,region)**:
- The MIxS term [`Geographic location (country and/or sea,region)`](https://genomicsstandardsconsortium.github.io/mixs/0000010/) is used to record this information in the format `Country:Region, Locality`.
- Country or sea names should be chosen from the [INSDC country list](http://insdc.org/country.html), or the [GAZ ontology](http://purl.bioontology.org/ontology/GAZ)
- This term is not intended for the archaeological/palaeontological/ecological site name (if relevant). Instead, include the site name under the MInAS-specific term `Name of site or location where sample was originated`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- This term is not intended for the archaeological/palaeontological/ecological site name (if relevant). Instead, include the site name under the MInAS-specific term `Name of site or location where sample was originated`.
- The term `Geographic location (country and/or sea,region)` is not intended for the archaeological/palaeontological/ecological site name (if relevant). Instead, include the site name under the MInAS-specific term `Name of site or location where sample was originated`.

Co-authored-by: James A. Fellows Yates <jfy133@gmail.com>
Co-authored-by: Deon de Jager <dejager4@gmail.com>
Comment thread docs/documentation/user-documentation/faq.md Outdated
DeondeJager and others added 2 commits August 3, 2026 11:51
Co-authored-by: James A. Fellows Yates <jfy133@gmail.com>
Co-authored-by: Deon de Jager <dejager4@gmail.com>
@DeondeJager

Copy link
Copy Markdown
Contributor Author

@jfy133 Can we merge and close this branch? Any additional edits/updates can be done in a new issue & branch.

@DeondeJager

Copy link
Copy Markdown
Contributor Author

Closes #23

@DeondeJager
DeondeJager requested a review from vicyklee August 10, 2026 08:53
@DeondeJager
DeondeJager merged commit f05bbe8 into master Aug 10, 2026
@DeondeJager
DeondeJager deleted the Update-FAQs-20250922 branch August 10, 2026 09:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants