Onboarding Checklist¶
Welcome to Data Management. This page gives you an overview of the accounts you’ll have as a member of DM.
Note
Some things you can set up yourself, but many accounts require action by your manager. We’ve given them a handy Checklist for T/CAMs at the bottom.
LSST account¶
Your manager — or T/CAM, in LSST jargon — will request a single sign-on account for you. This gives you access to:
The internal project website, including travel requests: http://project.lsst.org
An e-mail address of the form
username@lsst.org
:AURA employees will be able to access the AURA e-mail system at https://mail.lsst.org/owa
For non-AURA employees, this will forward to your institutional address (as registered with the Contacts Database)
The Jira project management tool: http://https://rubinobs.atlassian.net/
The Confluence wiki: https://confluence.lsstcorp.org
The DocuShare document archive: https://docushare.lsst.org
The IT Team have some further information about Docushare. Note in particular the comments on licensing.
You can always update or reset your LSST password at https://pwdreset.lsst.org/
Finally, read over the LSST Project’s New Employee Onboarding page. That will get you up to speed with the LSST Project; the rest of this page is specific to DM.
Data Facility resources¶
You’ll also need an account for the US Data Facility services, hosted at SLAC, which include:
You must sign up for this account separately via this procedure.
GitHub and LSST organizations¶
If you don’t have one already, create an account on https://github.com.
Next, ask your T/CAM to add you to the lsst and lsst-dm GitHub organizations, along with any relevant team organizations (send your GitHub username to your T/CAM).
See also
Git Configuration Standards & Recommendations page for recommendations on setting up two-factor authentication and credential helpers for GitHub.
Using Git LFS (Large File Storage) for data repositories page for configuring Git LFS for DM.
Community.lsst.org¶
https://community.lsst.org is LSST’s public-facing discussion and support forum. Browse the forum-howto tag to learn how to use the platform.
Create an account, and let your T/CAM know your username to get access to internal discussion categories.
Slack¶
Slack is LSST’s real-time chat platform. It is used across the project and by external science collaborations. Please be aware of our guidance on Providing Support to the Community when interacting with the latter.
Ask your T/CAM for access to the ‘lsstc’ Slack team. You can access it online at https://lsstc.slack.com, and through Slack’s mobile and desktop apps. Slack’s online help is a great way to learn Slack’s features.
Be sure to link your GitHub profile to your Slack account so that our Slack integrations will work correctly.
Channels set up specifically for Data Management related discussion have a ‘dm-’ prefix. Some important channels are:
announce-everyone for project-wide announcements.
lsst-travel for help with travel on project business.
lsst-newchannels for notifications of new channels.
software-dev for anything about writing software.
dm for general DM discussion.
dm-square for developer support services.
dm-jenkins for automatic notifications from our Continuous Integration system.
dm-tavern for “water cooler” type talk.
dm-tea-time for more serious but still non-LSST conversation.
dm-admin-support to contact DM’s administrator.
Your team may also have specific channels, and you can send private messages to individuals.
Mailing lists¶
We don’t use mailing lists for conversations, but they’re still used for notifications about RFCs and conversations happening on https://community.lsst.org. You will automatically be be subscribed to these lists as soon as you get an LSST acccount:
dm-staff (internal list)
Calendars¶
Important DM meetings are listed on this Google Calendar, to which you may wish to subscribe. More information is available about the various DM Calendars which are available.
Checklist for hires¶
In summary, here are the things you can do to get started:
Send a profile photo to your T/CAM for our team page.
Send your GitHub username to your T/CAM.
Send your https://community.lsst.org username to your T/CAM.
Follow emailed directions to set up your LSST account (including email), SLAC account, and Slack account.
Further steps¶
While you’re waiting on your accounts, here are some additional steps to help smooth your entry into the Rubin Observatory software team:
Familiarize yourself with our code of conduct.
Read these tips on using our large slack.
Configure your editor to better integrate with the Science Pipelines workflow.
Check out our coding style guides; our python style is mostly enforced by flake8 as a Github Action.
Ensure your git and GitHub configuration uses your institutional email address, and is tuned to help your development process.
Begin becoming familiar with our development workflow: this will be an ongoing process as you work with other DM developers.
Browse this guide’s sidebar and use the search box: we’ve tried to provide guidance to help ensure consistent code quality and help you work within this large collaboration.
Checklist for T/CAMs¶
Onboarding¶
Here’s what T/CAMs need to do to get their new hire started:
Fill out the Project onboarding form.
There’s no need to upload a photo to DocuShare, see the next step instead.
Under “User should belong to which Mailing Lists,” add
dm-devel
anddm-announce
. IT automatically adds DM hires todm-staff
.
Ask your new hire for a profile photo and add it to https://confluence.lsstcorp.org/display/DM/The+Team.
Add the new hire to the DM Team Google spreadsheet with time allocation information.
Add the hire as a member of the ‘Data Management’ team in each these GitHub organizations:
Add the hire as a member of these Community forum groups:
Give the hire’s email address to a Slack administrator: @brianv0, @jonathansick, and @frossie, can make Slack accounts.
You must inform your new hire that they need to follow the SLAC Onboarding Procedure.
Departing¶
When a member of your staff leaves the project, they can end up in one of two states:
Offboarded
An offboarded member of staff loses access to all LSST services. They retain builder status if they have accrued enough time with the project. To transition a member of staff to this status, fill out the offboarding form and ensure they are set to 0% contribution in the team spreadsheet. Remove the individual from GitHub organizations, teams, and repos.
Friendly
“Friendly” individuals are no longer on the LSST payroll, but continue to collaborate with the project. As such, they retain access to services such as Jira, Confluence, etc. However, they will be removed from the
dm-staff
mailing list. Do not fill out an offboarding form for friendlies. Instead, simply set their contribution to 0% in the spreadsheet and send an e-mail to the DM Admin to let her know. Refer to Document-27073 for more information on friendly status. Consider changing the individual’s GitHub status to “collaborator”.
In addition, the LSST Communications Team request that you notify the dm-staff mailing list of any departures from your team following the template in Document-26947.
Checklist for the DM Admin¶
Here’s what the awesome DM admin does:
After the onboarding form is received, send a welcome email to the hire with bullet points about the travel profile, Google calendar access, ContactDB info, and other miscellaneous project into. CC this to the supervisor.
Add a photo to the DM staff gallery, if not already done by the T/CAM.
Notify the LSST Digest editor and travel administrator.
Provide Google calendar access to DM Meetings and DM Travel/Vacation (for DMLT members only).
For details on LSST IT’s account onboarding procedures, see Account Management in the IT Support Confluence.