From c0f3b3556c5f366003a1f46f55835a1e31057ea9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antoine=20Beaupr=C3=A9?= <anarcat@debian.org>
Date: Wed, 19 May 2021 16:18:38 -0400
Subject: [PATCH] move tweaks to onboarding
---
howto/new-person.md | 39 ++++++++++++++++++++++++---------------
1 file changed, 24 insertions(+), 15 deletions(-)
diff --git a/howto/new-person.md b/howto/new-person.md
index 7f2f53d6..8ba8f9fe 100644
--- a/howto/new-person.md
+++ b/howto/new-person.md
@@ -11,8 +11,9 @@ user management procedures, see [issue 40129](https://gitlab.torproject.org/tpo/
* TPA: Tor Project Admins, synonymous with TSA, preferably used to
disambiguate with [the other TSAs](https://en.wikipedia.org/wiki/TSA)
* TPI: Tor Project Inc. the company that employs Tor staff
- * TPO: TorProject.Org, machines officially managed by TSA
- * TPN? torproject.net, machines in DNS but not officially managed by TSA
+ * TPO: `torproject.org`, machines officially managed by TSA, often
+ shortened as `.tpo`, for example. `www.tpo`
+ * `torproject.net`, machines in DNS but not officially managed by TSA
* a sysadmin can also be a service admin, and both can be paid work
# Orienteering
@@ -21,20 +22,25 @@ user management procedures, see [issue 40129](https://gitlab.torproject.org/tpo/
* [service list](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service)
* [machines list](https://db.torproject.org/machines.cgi)
* key machines:
- * Puppet: `pauli`
* [jump host](/doc/ssh-jump-host) and "general shell server": `perdulce`
- * Nagios: `hetzner-hel1-01.torproject.org`
- * LDAP: `alberti`
* IRC idling host: `chives`
+ * Puppet: `pauli`
+ * LDAP: `alberti`
+ * Nagios: `hetzner-hel1-01.torproject.org`
* Main mail server: `eugeni`
- * Master ganeti nodes: `fsn-node-01`, `chi-node-01`
+ * Master Ganeti nodes: `fsn-node-01`, `chi-node-01`
* key services:
- * [Grafana](howto/grafana): <https://grafana.torproject.org>, password on `admin/tor-passwords.git`
- * [git](howto/git): <https://gitweb.torproject.org/>, or `git@git-rw.torproject.org` over SSH
- * [GitLab](howto/gitlab): <https://gitlab.torproject.org/> - issue tracking and project management
- * [RT](howto/rt): <https://rt.torproject.org/> - not really used by TPA yet
- * spec: <https://spec.torproject.org/> - for a series of permalinks
- to use everywhere, including especially `bugs.tpo/NNN`
+ * [Grafana](howto/grafana): <https://grafana.torproject.org> - monitoring
+ dashboard, password on `admin/tor-passwords.git`
+ * [Nagios](howto/nagios):
+ <https://nagios.torproject.org/cgi-bin/icinga/status.cgi?allunhandledproblems>
+ legacy alert dashboard
+ * [GitLab](howto/gitlab): <https://gitlab.torproject.org/> - issue tracking,
+ project management, and git repository hosting
+ * [git](howto/git): <https://gitweb.torproject.org/>, or
+ `git@git-rw.torproject.org` over SSH - legacy git repository
+ hosting
+ * see also the full [service list](service)
* key mailing lists:
* <tor-project@lists.torproject.org> - Open list where anyone is welcome to watch but posting is moderated. Please favor using this when you can.
* <tor-internal@lists.torproject.org> - If something truly can't include the wider community then this is the spot.
@@ -44,13 +50,13 @@ user management procedures, see [issue 40129](https://gitlab.torproject.org/tpo/
* <torproject-admin@torproject.org> - TPA-specific "mailing list"
(not a mailing list but an alias)
* IRC channels:
- * `#tor-project` - general torproject channel
+ * `#tor-project` - general Tor project channel
* `#tpo-admin` - channel for TPA specific stuff
* `#tor-internal` - channel for private discussions, need secret
- password and being added to the `@tor-tpomember` with GroupServ,
+ password and being added to the `@tor-tpomember` with `GroupServ`,
part of the `tor-internal@lists.tpo` welcome email)
* `#tor-bots` - where a lot of bots live
- * `#tor-nagios` ... except the nagios bot, which lives here
+ * `#tor-nagios` ... except the Nagios bot, which lives here
* `#tor-meeting` - where some meetings are held
* `#tor-meeting2` - fallback for the above
* TPI stuff: see employee handbook from HR
@@ -79,6 +85,9 @@ user management procedures, see [issue 40129](https://gitlab.torproject.org/tpo/
8. [Documentation design](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/documentation#design)
9. [Ganeti operations manual](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/howto/ganeti)
+The full documentation is available in the wiki and particularly from
+the [service list](service).
+
# Accounts to create
This section is specifically targeted at *existing* sysadmins, which
--
GitLab