Update faqs 20250922 Geographic metadata FAQ & fix typos by DeondeJager · Pull Request #14 · MIxS-MInAS/MIxS-MInAS.github.io

DeondeJager · 2025-09-22T09:58:23Z

No description provided.

- Filled-in geographic metadata FAQ. - Fixed a couple of typos.

jfy133

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

docs/documentation/user-documentation/faq.md

Updated geography FAQ by removing some details and adding an example.

jfy133

Additional minor comments

jfy133 · 2026-01-12T10:13:50Z

docs/documentation/user-documentation/faq.md

 _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.


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.

jfy133 · 2026-01-12T10:15:27Z

docs/documentation/user-documentation/faq.md


-_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.


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))

docs/documentation/user-documentation/faq.md

As suggested by James [here](https://github.com/MIxS-MInAS/MIxS-MInAS.github.io/pull/14/changes#r2681621333)

jfy133

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

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

MIxS and MInAS has two ways of representing geographical information about a sample
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)
For the former, use the MIxS terms XYZ... (with specific guidance for each term, e.g. lat_lon precision)
For the latter, use the MInAS terms orig_... (with specific guidance for each term, e.g. lat_lon precision)
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 :)

jfy133 · 2026-03-02T20:19:24Z

docs/documentation/user-documentation/faq.md

 _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)`. 


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)`.

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)`.

I guess it's four ways (or at least two), given our new orig_* terms

(epending on what you mean by 'two ways')

jfy133 · 2026-03-02T20:21:26Z

docs/documentation/user-documentation/faq.md

+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.


I would flip this:

By default we assume samples were sampled directly from the environment/burial context

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

jfy133 · 2026-03-02T20:21:49Z

docs/documentation/user-documentation/faq.md

+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)`. 
+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.
+Both of these are required fields and we suggest filling in at both terms with as precise information as possible. 


Suggested change

Both of these are required fields and we suggest filling in at both terms with as precise information as possible.

Both of these are required fields and we suggest filling in at both the coordinate and location name terms with as precise information as possible.

jfy133 · 2026-03-03T08:10:19Z

docs/documentation/user-documentation/faq.md

+Both of these are required fields and we suggest filling in at both terms with as precise information as possible. 

-_TODO_
+If the specimen is from a museum, we still need to record the original location of the specimen, which is the site from which it was excavated. 


Suggested change

If the specimen is from a museum, we still need to record the original location of the specimen, which is the site from which it was excavated.

If the specimen is from a museum, we still need to record the original location of the specimen, which is the site from which it was excavated (e.g. burial site or natural environment prior archiving in a museum).

jfy133 · 2026-03-03T08:10:21Z

docs/documentation/user-documentation/faq.md

+In this case, use the MInAS site terms: 
+    -    _insert site_location term_
+    -    _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.


Suggested change

- `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.

- `orig_site_loc`, which should be the local geographic name (e.g. closest town/region/named area on a map)

- `orig_site_lat`, which should be the latitude of the original burial site/natural environment

- `orig_site_lon`, which should be the longitude of the original burial site/natural environment

- `orig_site_name`, which should be used to record the name of the archaeological/palaeontological site.

jfy133 · 2026-03-03T08:11:01Z

docs/documentation/user-documentation/faq.md

+    -    _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)**:


OK I'm confused by the order again 😅

DeondeJager added 2 commits September 22, 2025 11:54

Update faq.md Geographic metadata & typos

6e0a9a6

- Filled-in geographic metadata FAQ. - Fixed a couple of typos.

Update faq.md Fix ticks around term names.

5229823

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

jfy133 reviewed Nov 17, 2025

View reviewed changes

docs/documentation/user-documentation/faq.md Show resolved Hide resolved

docs/documentation/user-documentation/faq.md Outdated Show resolved Hide resolved

docs/documentation/user-documentation/faq.md Show resolved Hide resolved

Update faq.md

9fa52ab

Updated geography FAQ by removing some details and adding an example.

DeondeJager requested a review from jfy133 January 12, 2026 10:11

jfy133 reviewed Jan 12, 2026

View reviewed changes

Update Geographic location faq.md

37bd8db

Need to rewrite this FAQ once site location terms have been added (see MIxS-MInAS/extension-ancient#45 (comment))

DeondeJager commented Feb 23, 2026

View reviewed changes

docs/documentation/user-documentation/faq.md Outdated Show resolved Hide resolved

Move grain of sand to footnote.

c963207

As suggested by James [here](https://github.com/MIxS-MInAS/MIxS-MInAS.github.io/pull/14/changes#r2681621333)

jfy133 reviewed Mar 3, 2026

View reviewed changes

	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)`.

	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)`.

		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.

	Both of these are required fields and we suggest filling in at both terms with as precise information as possible.
	Both of these are required fields and we suggest filling in at both the coordinate and location name terms with as precise information as possible.

	If the specimen is from a museum, we still need to record the original location of the specimen, which is the site from which it was excavated.
	If the specimen is from a museum, we still need to record the original location of the specimen, which is the site from which it was excavated (e.g. burial site or natural environment prior archiving in a museum).

-    -    `Name of site or location where sample was originated`, which should be used to record the name of the archaeological/palaeontological site.
+    -   `orig_site_loc`, which should be the local geographic name (e.g. closest town/region/named area on a map)
+    -   `orig_site_lat`, which should be the latitude of the original burial site/natural environment
+    -  `orig_site_lon`, which should be the longitude of the original burial site/natural environment
+    -   `orig_site_name`, which should be used to record the name of the archaeological/palaeontological site.

Conversation

DeondeJager commented Sep 22, 2025

Uh oh!

jfy133 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jfy133 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jfy133 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants