Communications and Collaborative Tools

The Mu2e Collaboration uses a variety of resources for communication within the collaboration, institutional memory and communication to the outside world. Those resources are described here:

The Mu2e Document Database

This is the core of Mu2e's institutional memory, containing talks, internal notes, policies, planning documents and project management documents. It also contains copies of selected external documents to ensure that we have a reliable reference copy.

• https://mu2e-docdb.fnal.gov/cgi-bin/sso/DocumentDatabase/ (Use SSO password)
• General information and guidelines for use.

The Mu2e Web Site

• The main Mu2e public presence on the internet is: https://mu2e.fnal.gov.
• There is also content restricted to those working on Mu2e: https://mu2e.fnal.gov/atwork/.
  • The restricted pages are accessed using your SSO credentials.
• The internal part of the web site is main web presence of the Mu2e Construction Project and many of the subsystems.
• Tools for monitoring data processing and data quality are accessed via the web site; many more of these will be developed as we approach data taking.
• Most of the computing and simulation related content has been moved off the web site and is now on the Mu2e Wiki.
• We anticipate that the organization of physics work will be on the Mu2e Wiki, not on the web site.

Wikis

The Mu2e wiki was created long after the Mu2e web site. The collaboration has decided that some mature content will always remain on the web site and that some developing content has been moved to the wiki. All of the computing and software documentation is on the wiki. Most new content should be added to the wiki.

For technical reasons Mu2e has two wikis, one for public content and one restricted to people working on Mu2e

• https://mu2ewiki.fnal.gov/wiki
• https://mu2einternalwiki.fnal.gov/wiki

To access either site you need to authenticate using your SSO password. This lets you see the full content of the public site and the front page of the internal site. This step only gets your through a Fermilab firewall and anyone with Fermilab SSO credentials can do this. Editing the public site is restricted to Mu2e members; to edit the site you need to login using the button in the upper right corner. To see beyond the front page of the internal site, you need to log in to the site.

The Mu2e-II project has it's own wiki:

• https://mu2eiiwiki.fnal.gov/wiki/Mu2e-II

Like the internal site, this page is protected by two layers of SSO. The first layer lets you see the front page. To see the full site you need to log in. The authorization list to loginfor this site is maintained separately than the authorization list for the two Mu2e sites. To be added to the list, contact the Mu2e-II leadership.

Slack

There is Mu2e Slack workspace. For details see our Slack wiki page.

Hypernews

Hypernews (hnews) is an 1990's era discussion forum technology that will be phased out as soon as Fermilab Computing identifies and deploys a replacement. Our hnews site hosts many forums; to participate in a forum you must subscribe to it.

Mu2e uses hypernews for 3 purposes:

1. Announcements
2. Threaded complex discussions that are part of the institutional memory of the collaboration, such as internal pre-publication reviews. This is what it does best.
3. Quick turn around discussions, most of which have little archival value. Most of these discussions have moved to #Slack.

Links:

• To log into Mu2e hnews: https://mu2e-hnews.fnal.gov/
• Instructions on how to log in: https://mu2e.fnal.gov/atwork/general/userinfo/hypernews/index.shtml
• Mu2e policy for using hnews: https://mu2e-docdb.fnal.gov/cgi-bin/sso/RetrieveFile?docid=6299&filename=Mu2eHNPolicy.pdf

Some of the Mu2e working groups use a hypernew forum for communications. Others use #Listserv_Mailing_Lists lists. When you join a working group, check which they use and subscribe yourself to their list or forum.

Listserv Mailing Lists

The Fermilab listerv system is technology for distributing announcements to mailing lists. The main Mu2e mailing list, to which all general announcements are sent, is a listserv list.

When you join Mu2e you are often, but not always added to this list. To check if you are on this list:

Send an email to listerv@fnal.gov
Leave the subject empty
Write on one line: review mu2emailing

You will get two replies from the listserv. One of them has the subject line "Re: REVIEW MU2EMAILING"; if it says that you are not authorized to review the list, then you are not on the list. To subscribe

 Send an email to listerv@fnal.gov
 Leave the subject empty
 Write on one line: subscribe mu2emailing firstname lastname

Note that you can only send email to the list using the email address from which you subscribed.

For more information see:

• https://listserv.fnal.gov/ (the listserv documentation)
• https://mu2e.fnal.gov/atwork/general/mailinglists/index.shtml (Mu2e specific information)

Some of the Mu2e working groups use listserv lists to communicate. Others use Mu2e #Hypernews. When you join a working group, check which they use and subscribe yourself to their list or forum.

Electronic Collaboration Logbook (ECL)

The Electronic Collaboration Logbook is used for logging activities and events thoughout Mu2e construction, installation, commissioning, operation, etc.

 https://dbweb0.fnal.gov/ECL/mu2e

When you request an account, you must request that your username be your SSO username. When you authenticate use your SSO password.

If you are working on any data taking activity, such as a test stand, test beam, or Vertical Slice Test, you will need to request an account on the ECL.

GitHub

The primary source code management system for the Mu2e experiment software.

https://github.com/Mu2e/

See also GitHubWorkflow.

Social Media

• https://twitter.com/Mu2eExperiment

Fermilab Public DocDB

Prior to summer 2020 the Mu2e DocDB held many documents that were readable by the general public, such as slides shown at conference talks or colloquia. Starting in the summer of 2020 Fermilab changed its security policy and most DocDB instances at Fermilab are no longer allowed to have documents that are publicly readable. This includes the Mu2e DocDB.

At that time the lab created a new DocDB instance, the Fermilab Public DocDB, that holds only documents that may be viewed by the public:

 https://publicdocs.fnal.gov/cgi-bin/DocumentDatabase

Mu2e has not made much use of this DocDB instance; most of our public documents are either available from other sources or are out-of-date. Other sources include arXiv.org or publishers' urls, which can be found via INSPIRE. One important Mu2e document can be found in this DocDB instance, the Mu2e Data Management Plan, that must be cited in many grant applications,

https://publicdocs.fnal.gov/cgi-bin/ShowDocument?docid=515

The guidelines for adding a new document to the Fermilab Public DocDB are available at:

 https://fermi.servicenowservices.com/kb_view.do?sysparm_article=KB0014035#instructions
 (to see this article you must first log into the service desk and then click on the link)

The documents in the Mu2e DocDB that were formerly public are still there; they now belong to a group named "waspublic". This group is configured so that any they can be read by any member of Mu2e but not by the public.

Other

• https://en.wikipedia.org/wiki/Mu2e (is this social media?)

Should we also discuss:

• Redmine (being phased out)
• Fermilab Tech Pubs
• ArXiv.org
• Teamcenter
• INSPIRE