Skip to content

Commit

Permalink
Merge pull request #134 from RobLBaker/main
Browse files Browse the repository at this point in the history
Fix documentation/typo in set_int_rights documentation for EML Script Creation
  • Loading branch information
RobLBaker authored May 14, 2024
2 parents 8bcca6b + 196f69f commit c7f3eb0
Show file tree
Hide file tree
Showing 6 changed files with 41 additions and 28 deletions.
4 changes: 3 additions & 1 deletion NEWS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# EMLeditor v0.1.6 (in progress)
## 2024-05-01
* Fix documentation: typo/formatting for the description of `set_int_rights()` in the EML Creation Script github.io page.
## 2024-04-29
* Bug fix for set_cui's deprecation message: now points to the correct updated function.
* Bug fix for `set_cui()` deprecation message: now points to the correct updated function (`set_cui_code()`).

## 2024-04-08
* Bug fix for `set_doi()`, which was not always updating dataTable URLs.
Expand Down
44 changes: 26 additions & 18 deletions docs/articles/a02_EML_creation_script.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 3 additions & 2 deletions docs/news/index.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/pkgdown.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ articles:
a03_Template_edits: a03_Template_edits.html
a04_Editing_fixing_eml: a04_Editing_fixing_eml.html
a05_advanced_functionality: a05_advanced_functionality.html
last_built: 2024-04-30T14:39Z
last_built: 2024-05-02T04:11Z
urls:
reference: https://nationalparkservice.github.io/EMLeditor/reference
article: https://nationalparkservice.github.io/EMLeditor/articles
Expand Down
2 changes: 1 addition & 1 deletion docs/search.json

Large diffs are not rendered by default.

12 changes: 7 additions & 5 deletions vignettes/a02_EML_creation_script.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -241,11 +241,12 @@ if your EML is not schema valid, the function will notify you of specific proble
Now that you have valid EML metadata, you need to add NPS-specific elements and fields. For instance, unit connections, DOIs, referencing a DRR, etc. More information about these functions can be found at: [https://nationalparkservice.github.io/EMLeditor/](https://nationalparkservice.github.io/EMLeditor/).

## Add Controlled Unclassified Information (CUI) codes
This is a required step. It is important to indicate not only that your data
package contains CUI, but also to inform users if your data package does NOT
contain CUI because empty fields can be ambiguous (does it not contain CUI or
did the creators just miss that step?). You can choose from one of five CUI
dissemination codes. Watch out for the spaces! These are:
This is a required step, using the function `set_cui_code()`. It is important to
indicate not only that your data package contains CUI, but also to inform users
if your data package does NOT contain CUI because empty fields can be ambiguous
(does it not contain CUI ordid the creators just miss that step?). You can choose
from one of five CUI dissemination codes. Watch out for the spaces! These are:

* PUBLIC - Does NOT contain CUI.
* FED ONLY - Contains CUI. Only federal employees should have access (similar to "internal only" in DataStore).
* FEDCON - Contains CUI. Only federal employees and federal contractors should have access (also very much like current "internal only" setting in DataStore).
Expand All @@ -263,6 +264,7 @@ my_metadata <- EMLeditor::set_cui_code(my_metadata, "PUBLIC")

## Intellectual Rights
EMLassemblyine and ezEML provide some attractive looking boilerplate for setting the intellectual rights. It looks reasonable and so is easy to just keep. However, NPS has some specific regulations about what can and cannot be in the intellectualRights tag. Use `set_int_rights()` to replace the text with NPS-approved text. Note: You must first add the CUI dissemination code using `set_cui()` as the dissemination code and license must agree. That is, you cannot give a data package with a PUBLIC dissemination code a "restricted" license (and vise versa: a restricted data package that contains CUI cannot have a public domain or CC0 license). You can choose from one of three options:

* "restricted": If the data contains Controlled Unclassified Information (CUI), the intellectual rights must read: **"This product has been determined to contain Controlled Unclassified Information (CUI) by the National Park Service, and is intended for internal use only. It is not published under an open license. Unauthorized access, use, and distribution are prohibited."**

* "public": If the data do not contain CUI, the default is the public domain. The intellectual rights must read: **"This work is in the public domain. There is no copyright or license."**
Expand Down

0 comments on commit c7f3eb0

Please sign in to comment.