ISIS Neutron and Muon Source Data Policy
This is a Github repository for tracking revisions of the ISIS Data Policy.
The latest version is available on the ISIS website from https://www.isis.stfc.ac.uk/Pages/Data-Policy.aspx.
Working With The Repository
It is recommended that Visual Studio Code
with the markdownlint
extension be used to edit the policy. If Format on Save is enabled then the
extension will automatically fix any issues with the document such as extraneous
whitespace or bare external links. This check is also part of a
GitHub Action workflow check
the documents when opening a pull request or pushing to the default branch.
The action also has an additional check for dead external links using markdown-link-check.
Creating a New Version
To create a new version of the policy:
- Create a branch and make the required changes to the document.
- Check, and update if necessary, the .zenodo metadata.
- Open a pull request to merge to the default branch.
- Send an email to the review group asking for any further comments and provide a link to the pull request plus a word copy of the document as it would look for those without GitHub access. Ask for feedback within 1 month.
- Once all feedback has been processed and the final changes to the document have been made the pull request can be merged.
- Create a new GitHub release, including a bullet list of the major changes in the description.
- Once published check Zenodo has created a fresh DOI.
- Finally, update the policy on the public ISIS website.
Reviews
The policy is reviewed annually. Minutes and notes from the meetings can be found in the reviews repository (restricted access).