Migrate onboarding page from the wiki to sysadm docs

Related to T3154

docs/contributing/phabricator.rst

@@ -27,6 +27,8 @@ We use the Differential application of Phabricator to perform
 Configuration
 +++++++++++++
 
+.. _arcanist-configuration:
+
 Arcanist configuration
 ^^^^^^^^^^^^^^^^^^^^^^
 

sysadm/user-management/onboarding.rst

@@ -3,7 +3,102 @@
 Reference: Onboarding checklist
 ===============================
 
-.. todo::
-   This page is a work in progress. For now, please refer to the `existing documentation
-   <https://intranet.softwareheritage.org/wiki/Onboarding>`_.
+This page describes the onboarding process for new staff member on the project.
 
+.. _onboarding_goodies:
+
+Goodies
+-------
+
+- give out Software Heritage t-shirt and stickers!
+
+.. _onboarding_administrative:
+
+Administrative
+--------------
+
+- Inria access badge and office keys
+- Sign PV d'installation
+- Create Inria account
+- `cantine card <https://intranet.softwareheritage.org/wiki/Cantine_card>`_
+- `transportation expenses <https://intranet.softwareheritage.org/wiki/Transportation_expenses>`_
+- Add picture (150x150px) and short bio to the `people page
+  <https://www.softwareheritage.org/people/>`_
+
+- Review the `team charter <https://intranet.softwareheritage.org/wiki/Team_charter>`_
+
+.. _onboarding_technical_setup:
+
+Technical setup
+---------------
+
+- Create \*nix account and email alias on project machines (swh-site puppet repo)
+
+   - Set \*nix password for the account (swh-private-data puppet repository)
+
+- Set up email forwarding on `gandi <https://admin.gandi.net/dashboard>`_
+
+- Configure printer:
+
+   - if the machine was configured through puppet: add printer alias per \*nix account
+     mapping \*nix account to the inria's ldap account if different
+
+   - Otherwise, check the `SIC documentation`_. If the page looks empty/broken, make
+     sure you select "Space language: French" (the English translation is missing)
+
+- Create `Phabricator`_ account
+
+   - add user to phabricator `projects <https://forge.softwareheritage.org/project/>`_:
+     Developers, Staff, Reviewers, Interns (if applicable)
+
+- `VPN <https://intranet.softwareheritage.org/wiki/VPN>`_ access
+- HTTP auth credentials for the `intranet wiki`_
+- Create account on the `intranet wiki`_
+- Create account on the `public wiki`_
+
+Extra steps for sysadm:
+
+- Add GPG key to password manager
+- Add GPG key to allow debian package upload
+  (pergamon:/srv/softwareheritage/repository/conf/uploaders)
+
+.. _onboarding_communication:
+
+Communication
+-------------
+
+- Subscribe to `mailing lists`_: swh-devel, swh-team
+- Invite to `IRC channels`_
+- Create user page on the intranet (see `example
+  <https://intranet.softwareheritage.org/wiki/User:StefanoZacchiroli>`_) with personal
+  contact information
+- Subscribe to `team calendar
+  <https://intranet.softwareheritage.org/wiki/Team_calendar>`_
+
+.. _onboarding_training:
+
+Training
+--------
+
+- Read  `data model <swh-devel:data-model>`_
+- Read `python modules structure
+  <https://docs.softwareheritage.org/devel/#dependencies>`_
+- Follow `getting started tutorial
+  <https://docs.softwareheritage.org/devel/getting-started.html>`_
+- Have ``make check`` and ``make test`` pass there in swh-environment
+- `Configure arcanist <swh-devel:arcanist-configuration>`_ and submit a first diff
+  following the `code review <swh-devel:code-review>`_ workflow
+
+.. _onboarding_see_also:
+
+See also
+--------
+
+- `Outboarding <outboarding>`_ (i.e., what to do when a staff member *leave*)
+
+.. _SIC documentation: https://vpn1-roc.national.inria.fr/+CSCO+1h75676763663A2F2F7162702D66762E766165766E2E7365++/display/SU/impression+unifiee#expand-ConfigurerlimpressiondepuisunposteLinux
+.. _mailing lists: https://intranet.softwareheritage.org/wiki/Mailing_lists
+.. _IRC channels: https://intranet.softwareheritage.org/wiki/IRC_channels
+.. _intranet wiki: https://intranet.softwareheritage.org
+.. _public wiki: https://wiki.softwareheritage.org
+.. _Phabricator: https://forge.softwareheritage.org