# Proposal
After discussion the following structure emerged as proposal for the sysadm pages.
A new page [1] to add the documentation site. This could be publicly linked from the
main page [2] (or not). This could also be publicly exposed (or not as the current
intranet which is http-basic protected for example).
- Getting started
- [ ] [Puppet setup](https://intranet.softwareheritage.org/wiki/Puppet_setup)
- [ ] Check puppet manifests with vagrant
- [ ] Provision new vms
- [ ] Access to the Credential store](https://intranet.softwareheritage.org/wiki/Credential_storage)
- [ ] link to the phabricator tuto in devel doc
- ...
- How to
- [ ] [Debian packaging](https://wiki.softwareheritage.org/wiki/Debian_packaging#Updating_a_dependency_packaging_repository) (could be cross-linked maybe)
- [ ] [Database upgrade](https://intranet.softwareheritage.org/wiki/Upgrades)
- [ ] Database deployment
- [ ] Deploy a new swh module in staging/production
- [x] [Deploying a lister](https://intranet.softwareheritage.org/wiki/Deploying_a_lister)
- [x] [Keycloak](https://intranet.softwareheritage.org/wiki/Keycloak)
- [x] [Connect to a database](https://intranet.softwareheritage.org/wiki/Databases)
- [x] [Onboarding](https://intranet.softwareheritage.org/wiki/Onboarding)
- [x] [Outboarding](https://intranet.softwareheritage.org/wiki/Outboarding)
- Explanation
- Infrastructure
- [ ] Production
- [x] [Staging environment](https://intranet.softwareheritage.org/wiki/Staging_environment)
- [ ] [Network configuration](https://intranet.softwareheritage.org/wiki/Network_configuration)
- Source of truth -> Inventory
# Pros/cons
## pros
- code review ahead of time available (one could always skip it if they don't want to)
- tool unification (sphinx rst, git, ...)
## cons
No cons that I can see (well the migration per say but that can be done incrementally :)
# Remaining pages to redispatch eventually
- [Backups](https://intranet.softwareheritage.org/wiki/Backups)
- [Database inventory](https://intranet.softwareheritage.org/wiki/Databases_inventory)
- [IDRAC](https://intranet.softwareheritage.org/wiki/IDRAC) (-> credentials should be moved to credential store if missing first)
- [Jenkins](https://wiki.softwareheritage.org/wiki/Jenkins) -> actually to devel docs
- [IRC](https://wiki.softwareheritage.org/wiki/IRC)
- [Pglogical replication](https://intranet.softwareheritage.org/wiki/Pglogical_replication)
- ...
[1] https://docs.softwareheritage.org/sysadm/
[2] https://docs.softwareheritage.org/