DocDB: Difference between revisions
(No difference)
|
Revision as of 22:21, 2 June 2022
Apply for Access
- Visit https://mu2e-docdb.fnal.gov/cgi-bin/sso/DocumentDatabase
- If you are prompted for your services username and password enter them.
- You will see the main page of the Mu2e-docdb but you won't yet see any documents because you are not yet a member of any groups.
- In the left hand sidebar click on "Apply to Groups".
- On this page:
- Check that your username, name and email information are correct. If not, contact the Mu2e DocDB Administrators.
- On the right hand side there is a scrolling box of group names. Most people should select only "mu2e [General Read/Write Group]".
- If you are member of other groups, such as the Technical Board or Speakers Bureau, select additional groups too by right clicking on those groups.
- In the notes field tell us which university or lab you work for; for students, post-docs and technicians, please also tell us the name of your supervisor.
- Click on the "Apply for Access" button.
- This will send email to the Mu2e-DocDB administrators. Normally your access will be approved with in a few hours but it may occasionally take up to 1 day. You will receive an email when you are approved. If you apply on a weekend or holiday you may not get approval until the next working day.
Introduction
The Mu2e document management system is the Mu2e Docdb,
https://mu2e-docdb.fnal.gov/cgi-bin/sso/DocumentDatabase/
The word "document" should be understood its broadest sense: it can be a note written in Word or LaTex, a PDF file, a PowerPoint presentation, a photograph, a poster, a video, a construction drawing, indeed anything that we wish to archive and catalog; it could even be a scan of something sketched on the back of a napkin. The one exception is source code, which is maintained in a source code management system; most Mu2e code can be found in the Mu2e GitHub organization. The technology underlying the document database is an open-source project, originally developed at Fermilab, named DocDB.
A document may have many versions; each version may contain a single file or many files; there may be a different number of files or type of files in each version. The meta-data stored with each version of each document includes the author, the creation date, a list of topics and keywords, read/write permissions, a document type and associations with events such as collaboration meetings, subgroup meetings or conferences. There is a search function that works on the meta-data; there is no full text search capability. It is possible to update the meta-data for an existing document without changing the document. There is a mechanism for collecting sign-offs on controlled documents and to lock documents so that they may not be modified. One may write URLs directly to a document or to a file within a document. One may write a URL asking to show the version of a document that was current as of a given date; this simplifies the task of preparing, and preserving, a snapshot of DocDB for use in a review. There are many more features.
Mu2e also uses DocDB to present agendas for meetings; the agendas contain links to the documents presented at the meeting. In this way DocDB allows a unified view of all of our documents; it does not artificially separate documents shown at meetings from other documents.
You can set watches on documents, or on groups of documents, and will be notified when one of those documents is updated.
Documentation
Most of the features of DocDB are well documented by Docdb's own documentation, which is available from the top link in the left hand side bar of the docdb main page. The direct link is:
https://mu2e-docdb.fnal.gov/cgi-bin/private/DocDBInstructions
Look at the bottom of the left hand side bar of this page, under "All Instructions", to find links to additional documentation. Because docdb is such an important tool for everyone working on Mu2e, we recommend that you make some time to become familiar with all of this documentation.
Groups and Permissions
Docdb uses a group based permission system. The Mu2e docdb has many groups, three of which are "mu2e", "mu2e-techboard" and "reviewer". These three will be sufficient to illustrate the main ideas. Each version of each document has a list of groups that may read the document and a list of groups that may modify the document. Each individual user is assigned a list of groups to which they belong. A user may read any document that has read permission for one or more of their groups. A user may modify any document that has write permission for one or more of their groups.
All people working on Mu2e are members of the group "mu2e" and most are members of only that group. Members of the Mu2e Technical Board are also members of the group "mu2e-techboard". There are some documents that are readable only by members of the Technical Board and not by regular members of Mu2e.
When Mu2e is being reviewed, we indicate which documents will be visible to reviewers by adding the group "reviewer" to the read permission list of each of those documents. Each reviewer must apply for their own docdb account and the group "reviewer" is added to that account. In this way reviewers may see all documents that they are entitled to see but may not see other documents and may not modify or create any content in docdb.
At one time it was legal to mark documents as publicly readable. This is no longer permitted but the group "public" still appears as a possible group in the read permission list for a document. The lab periodically scans for such documents and tells the administrators to remove public permission.
Customizing Your Account
Coming soon.
Obsolete Documents
By design, neither documents nor versions of documents may be deleted by normal users; even when obsolete, they are still part of the audit trail of how we got to where we are. If you wish to mark a document as obsolete you can use the "Notes and Changes" field, you can edit the metadata to add "Obsolete" to the title or you can add a new version containing a brief note that the document is obsolete. In the rare case that it is important to delete a document, contact a Mu2e DocDB administrator; there is a mail link to the administrators at the bottom of each DocDB page. Normally we only do this for documents that contain information that should not be visible within Docdb.
Guidelines
Coming soon.