...
An AARC Guidelines identifier MUST be assigned to all version of the BPA, to all technical recommendations that pertain to the BPA, to all policy guidance that pertains to Infrastructure proxies and consortia of service providers or IdPs, and for specifications that should be adopted or implemented by the AARC peer organisations. It MUST be assigned to all document that will be published, and MAY be assigned to project deliverables and milestone documents that have value as guidance.
Assign numbers and review/edit status here:https://docs.google.com/spreadsheets/d/1rvxtSyZBucT0xUTcajWa4YOJ-A8_v4KKgun0aJR1AF4 |
---|
Document numbers can be assigned by the PMT members. Everyone can comment and suggest improvements (e.g. to the abstract or status).
A workable document template for those using MS Word is also attached to this page (it actually uses document properties correctly so can be indexed).
Status information and transitions
Each document has a status value assigned in the table
Status | Description | Next state(s) |
---|---|---|
Concept | Somebody thought that this topic merited guidance | In Progress |
Abandoned | This idea will not be pursued ever again, or only in a different context | - |
In Progress | Somebody actually started work on the idea. This must be reflected in a Wiki page that contains at least an abstract (few lines) and a link to discussion meetings or a draft document | Consultation |
On Hold | Work has been suspended under the assumption that it will be resumed later (e.g waiting on community feed-back or clarification of use cases) | Abandoned In Progress |
Consultation | The guidance has been developed sufficiently to expose a draft to the interested communities (REFEDS, AppInt, IGTF, WISE, or the WP mailing list | In Progress |
Final Call | Document has been sent to all of AARC and to all relevant stakeholders for final comment | In Progress |
Final | This guidance is now official AARC guidance and will be published in the 'main' lists of guidance documents on https://aarc-project.eu/guidelines/. This state must be reflected in the public page of the guideline under https://aarc-project.eu/guidelines/aarc-gXXX/ under "Status". A DOI must now be assigned if it has not been assigned already | - Endorsed Superseded |
Endorsed by ... | This guidance has been endorsed by a target audience of AARC (AEGIS) or an external peer body (REFEDS, IGTF, &c). It gives the document more status, and this must be reflected on the public guidlines pages. E.g. "Status: Endorsed by AEGIS", or "Status: Endorsed by REFEDS and AEGIS". | - |
It is RECOMMENDED that each document has a Guarding Angel that shepherds the document through the transitioning process. The GA MAY be the Editor.
...