PASTAplus / content-x

Repository for web-x static page content
Creative Commons Zero v1.0 Universal
0 stars 3 forks source link

Unlinked reference numbers [1] and [2] in "Data package accessibility" section of /about/edi-policy.md #4

Open servilla opened 2 years ago

servilla commented 2 years ago

There are unlinked reference numbers [1] and [2] in the "Data package accessibility" section of /about/edi-policy.md:

EDI strives to make environmental research data open and accessible to the general public without undue restrictions or barriers. Although EDI strongly recommends all data be publicly available, we recognize that some data may require limited access while it is under review during manuscript preparation. In these cases, the EDI Data Repository supports access control to data when justified by the data provider, thereby limiting exposure of the data resource to only users with appropriate permission [1]. Such access control must be clearly specified in the data package metadata. EDI will also accept data that requires a permanent embargo due to issues of sensitivity (e.g., the location of endangered species or antiquities). Although EDI will enforce access control of data as specified in the data package metadata, EDI does not guarantee the privacy of such information. If data are to be submitted to the EDI Data Repository with restricted access, we request that an explanation of the data embargo, including if and when the data will be made available to the general public, be provided in the data entity description field of the data package metadata. Only for extreme circumstances will EDI allow both the metadata and data to be restricted [2]. EDI reserves the right to periodically review restricted data to determine if embargos continue to be justified.

clnsmth commented 2 years ago

These reference numbers link to clauses at the end of the "Data package accessibility" section mirroring: https://environmentaldatainitiative.org/edi-data-policy-2/#Data%20Package%20accessibility. We had to switch from "*" and "**" since these characters have formatting implications in markdown.

I've super scripted the reference numbers and reformatted the referenced clauses to match usage in other pages (e.g. https://github.com/PASTAplus/content-x/blob/main/templates/resources/why-publish-data.md)

clnsmth commented 2 years ago

@servilla Does this solution work for you? Other ideas?

servilla commented 2 years ago

Here is another example of working with footnotes: https://web-x.edirepository.org/about/edi-policy#footnotes.

clnsmth commented 2 years ago

I like it. What does the markdown for it look like?

servilla commented 2 years ago

https://github.com/PASTAplus/content-x/commit/9c4e469912820e4161537aaf63f0c28668d9fe35

clnsmth commented 2 years ago

That should work. Several other pages will need to be updated to use this new approach. An issue can be opened to address this once the footnotes feature goes live.

I'm not a huge fan of adding more HTML styling to the .md files, so I'd vote for leaving out the horizontal line.

servilla commented 2 years ago

I'm not a huge fan of adding more HTML styling to the .md files, so I'd vote for leaving out the horizontal line.

works for me

clnsmth commented 2 years ago

I'll update other content-x pages to use the footnotes and separate them from the page body with a section header.