Communications and Collaborative Tools: Difference between revisions

From Mu2eWiki
Jump to navigation Jump to search
Line 96: Line 96:
==Indico==
==Indico==


Indico is open source software for creating meeting agenedae and archiving documents associated with those meetings, https://getindico.io . The agendae for most Mu2e meetings are maintained using the Mu2e [[DocDB]], which has similar features.  Many other meetings, particularly externally organized reviews, maintain the agendae using the Fermilab indico instance: https://indico.fnal.gov .  In such cases you will be given the url of the meeting.  Some content on the indico site is protected.  If you are on the authorization list for a particular event you authenticate using SSO.   CERN also has an indico site: https://indico.cern.ch and you may sometimes be invited to meeting hosted on that site.
Indico is open source software for creating meeting agenedae and archiving documents associated with those meetings, https://getindico.io . The agendae for most Mu2e meetings are created using the Mu2e [[DocDB]], which has similar features.  For many other meetings, particularly externally organized reviews, the agendae are created using Fermilab indico instance: https://indico.fnal.gov .  In such cases you will be given the url of the meeting.  Some content on the indico site is protected.  If the event that you are viewing is protected, you will be prompted to log in.  There are several ways to login; look for the link to use your Fermilab SSO credentials. CERN also has an indico site: https://indico.cern.ch and you may sometimes be invited to meeting hosted on that site. SLAC also has an indico site: https://indico.slac.stanford.edu/ .


==Glossary and Acronym Dictionaries==
==Glossary and Acronym Dictionaries==

Revision as of 15:15, 29 September 2023

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, project management documents and the working drafts of papers. It hosts the agendae for most Mu2e meetings. And it contains copies of selected external documents to ensure that we have a reliable reference copy.

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 most new content will be created on the wiki. All of the computing and software documentation is on the wiki.

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

For political reasons it was not possible to have one wiki with access controlled per page.

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 that site. You need to login separately to each site.

The Mu2e-II project has it's own public and internal wikis:

These sites have the same access rules as the Mu2e wiki sites. The only difference is that the authorization list is maintained separately. 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.

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.

A hnews site is organized into forums; to participate you need to first create an hnews account and then subscribe to forums of interest.

Some of the Mu2e working groups use a hypernews 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

Once you are subscribed to a list, you may also post to that list, but only using email address from which you subscribed.

For more information see:

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.

Zoom

Mu2e uses Zoom to host our meetings. Fermilab requires us to following their policies on Zoom security. See Zoom#Recommendations_for_Zoom_Security.

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

There is a link on that page to request an account; you must request that your username be your SSO username (same as your kerberos principal). When you authenticate, use your SSO password.

Check with the working groups your join to learn if you need to request an account on the ECL.

Indico

Indico is open source software for creating meeting agenedae and archiving documents associated with those meetings, https://getindico.io . The agendae for most Mu2e meetings are created using the Mu2e DocDB, which has similar features. For many other meetings, particularly externally organized reviews, the agendae are created using Fermilab indico instance: https://indico.fnal.gov . In such cases you will be given the url of the meeting. Some content on the indico site is protected. If the event that you are viewing is protected, you will be prompted to log in. There are several ways to login; look for the link to use your Fermilab SSO credentials. CERN also has an indico site: https://indico.cern.ch and you may sometimes be invited to meeting hosted on that site. SLAC also has an indico site: https://indico.slac.stanford.edu/ .

Glossary and Acronym Dictionaries

There are several glossaries that explain terms and acronyms used within Mu2e:

Both of these links contain links to additional acronym dictionaries.

Social Media

Email Forwarding

You have a Fermilab email address: username@fnal.gov, where username is your Fermilab username, also used for kerberos and SSO. For Fermilab employees, this is a real email address. For Fermilab Users, this address is configured to forward to the email address that you used when you applied for your Fermilab ID. Some tools in the lab computing infrastructure send announcements to your fnal.gov email address. If you no longer have access to the email address that you used when you applied for your Fermilab ID, open a ServiceDesk ticket to request that your forwarding be redirected to your new preferred email address.

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.

INSPIRE and ORCID

INSPIRE is an an organization that curates information about publications in High Energy Physics. You can use INSPIRE to view the citation history of a paper or to view the publication history of a member of the field, including yourself. An ORCID is a researcher identifier that is used by INSPIRE. Mu2e management requests that all Mu2e members have an ORCID. For more details see https://mu2e.fnal.gov/atwork/workgroups/PublicationsBoard/orcid.shtml .

Other

Fixme: also discuss:

  • Teamcenter