Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

An updated document is a new document with its own new row in the document repository, even though much of its content may be the same as the original document. 
Just as with the original document, the update is subject to review and approval, as specified by its sponsor.

There are a few of things to note:

  • The Repository ID of the original document will be listed as a "superseded document" on the superseding document's repository metadata page.
  • The "Deprecated" field of original document's repository metadata page will be "yes."
  • Numbering: When the superseding document is an update to the superseded document, its Repository ID will typically be the Repository ID of the original document after adding 1 to the version number. For example, an update to TI.22.3 would have TI.22.4 for its Repository ID. There are, however, exceptions to this numbering convention.  For example, the superseding document may be completely new, not an update, or there may simply be historical reasons why this was not done,
  • There are additional details for the Doc Repostiory Librarian at  https://spaces.at.internet2.edu/x/Y5iTBg 
  • Note that a revisable version of the older document may be available in the Development Location field of its repository metadata page, as well as other material that may help you.

...

Here is an example of a deprecated document http://doi.org/10.26869/TI.105.1

Documents that are presented elsewhere in Internet2's or InCommon's

...

website

Typically, references to documents in the repository should link to the documents' metadata pages via their DOI URL (e.g.http://doi.org/10.26869/TI.105.1).

There are times, however, when a document should be presented in a manner that is consistent with the context of the referring page, or when there are multiple references to the document , making make link maintenance difficult as new versions of the document is revisedare published. This alternative presentation is usually accomplished by creating a copy of the document's text, images, etc. within the technology platform used to present the referring page (e.g., WordPress for http://www.incommon.org). When this is done

See this example.

When a document in the repository is also presented on a webpage, the content "owner"  (note July 1, 2019: we may want to link from here a list of content owners and these pages) of the referring page should:

...

Working group chair and flywheel guidelines with regard to the Document Stewardship process are found here.

Please contact David Walker <dwalker@internet2.edu> or Emily Eisbruch <emily@internet2.edu> for Jessica Fink <jfink@internet2.edu> for more information.

Document Stewardship Process - Framework Docs

...