Closed jesse-ross closed 1 year ago
@jesse-ross where can we find the definitions of these status elements?
the "status" element is listed as "Development". A correct value should be chosen from these possibilities: "Ideation", "Development", "Alpha", "Beta", "Release Candidate", "Production", or "Archival"
@jesse-ross where can we find the definitions of these status elements?
the "status" element is listed as "Development". A correct value should be chosen from these possibilities: "Ideation", "Development", "Alpha", "Beta", "Release Candidate", "Production", or "Archival"
There isn't a super clear definition, even in the official guidance. I think there's room for you to interpret this as you think best.
Thanks @jesse-ross! I noticed that the paths to markdown files are blob
paths. Should those be changed to the raw
paths? From the guidance:
All URL paths to mark down (.md) files must be the full HTTPS machine readable "/-/raw/" version, not the html wrapped "/blob/" or other derivatives even though these derivatives may resolve correctly.
I noticed that the paths to markdown files are
blob
paths. Should those be changed to theraw
paths? From the guidance:
Good catch; thanks! Yes, I think it would be in accordance with the guidance to make that change.
If you made all of the changes, feel free to merge!
Starting on September 30, 2023, USGS GitHub repositories will no longer be permitted to remain in existing organizations such as USGS-R on the public GitHub. Instead, they must be either (a) migrated to the DOI GitHub Enterprise Cloud (DGEC), (b) migrated to the USGS GitLab instance, or (c) archived.
In order to be made public, all USGS software, whether provisional or approved, must contain all necessary legal and metadata assets. The purpose of this PR is to ease the transition by creating the necessary files, so that people can do the necessary migration work with less research time.
The files added here are generated based on some assumptions, and without looking at the contents of any existing files. For instance, if this repo already has a
LICENSE.md
, the process which is generating this PR will not add one to the PR, but it does not make any attempt to validate the existing file. Similarly, the code is not at all clever about finding similarly-named files. For instance, if you already have aLICENSE.txt
, this PR will try to create aLICENSE.md
anyways!The
DISCLAIMER.md
provided here is for a provisional release. If an official release is intended, a different disclaimer template may be found hereThe
LICENSE.md
provided here is the most common choice, but as the owner of the repository you need to look it over and make sure that it is a good match for your repository. The Office of the Solicitor is the only entity that can provide legal advice on this matter.Note especially that the
code.json
created by this PR will need to be manually edited in order to be correct. In this file, the following are likely to require modification:main
. If there are tagged versions, they will need to be added by hand.code.json
file will contain two sections, which are intended for different branches or version releases. You may want to remove one of these, or you may want to add more.For examples of valid
code.json
files, please see https://github.com/DOI-USGS/dataRetrieval/blob/main/code.json or https://github.com/DOI-USGS/snow-to-flow/blob/main/code.jsonIn addition to the necessary legal and metadata assets, all public software requires a security review. See this guidance for more information. Additionally, a useful FAQ with links to details of USGS policy and the specifics of this migration is located here.