Skip to content

Commit

Permalink
New language for deprecation of access element.
Browse files Browse the repository at this point in the history
Includes statement that access is considered advisory only.
  • Loading branch information
mbjones committed Sep 12, 2019
1 parent 58b4a09 commit b35ef17
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 10 deletions.
14 changes: 9 additions & 5 deletions docs/eml-220info.md
Original file line number Diff line number Diff line change
Expand Up @@ -280,13 +280,17 @@ backwards compatibility with a note that its use is deprecated.

## access elements deprecated

While eml-access has been part of the standard for many years, its use has been
While eml-access has been part of the standard for many years, use has been
extremely limited, and most systems seem to omit and ignore the `access` elements
in the document in favor of using repository-specific mechanisms to control access.
Therefore, EML 2.2.0 deprecates use of the `access` elements in EML documents, and
this module will be removed in a future version of EML. As this is a backwards
incompatible change, the elements are still available in EML 2.2.0, but expect them to
be removed in a future release.
Therefore, EML 2.2.0 deprecates use of the `access` elements in the main body of EML
documents, with the exception of use within the `additionalMetadata` element. As this is a
backwards incompatible change, the elements are still available in EML 2.2.0, but users
should expect schema changes to occur in a future release that eliminate the use of `access`
elements outside of `additionalMetadata`. In addition, because authorization systems
are system-dependent, the content within any `access` element should be considered
advisory and may not reflect the actual authorization policies in place at a given point
in time in a given repository.

## Supporting Semantic Metadata

Expand Down
16 changes: 11 additions & 5 deletions docs/eml-modules-utility.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,11 +61,17 @@ within the additionalMetadata field.

**DEPRECATED**

- *Note that use of the `eml-access` module is deprecated, as most systems
have internal representations of access control and have not been
provided or maintained. Thus, we no longer recommend using any of the
`access` elements throughout the schema, even though they have been
retained for backwards compatibility.*
- *While eml-access has been part of the standard for many years, use has been
extremely limited, and most systems seem to omit and ignore the `access` elements
in the document in favor of using repository-specific mechanisms to control access.
Therefore, EML 2.2.0 deprecates use of the `access` elements in the main body of EML
documents, with the exception of use within the `additionalMetadata` element. As this is a
backwards incompatible change, the elements are still available in EML 2.2.0, but users
should expect schema changes to occur in a future release that eliminate the use of `access`
elements outside of `additionalMetadata`. In addition, because authorization systems
are system-dependent, the content within any `access` element should be considered
advisory and may not reflect the actual authorization policies in place at a given point
in time in a given repository.*

Links:

Expand Down

0 comments on commit b35ef17

Please sign in to comment.