Merge pull request #7021 from DFE-Digital/update-onboarding-instructions

Minor updates on the onboarding instructions

documentation/onboarding.md

@@ -23,38 +23,48 @@ A team member with approver rights in [DfE Sign-in production environment](https
 This user allows the developer to visit the [Teaching Vacancies production support dashboard](https://teaching-vacancies.service.gov.uk/support-users), that provides access to the [production user feedback](https://teaching-vacancies.service.gov.uk/support-users/feedback/general) and [sidekiq](https://teaching-vacancies.service.gov.uk/sidekiq) dashboards.
 ## GitHub
 
-`#digital-tools-support` will add the new team member to the [DFE-Digital organisation](https://github.com/orgs/DFE-Digital/teams). We have three teams:
+`#digital-tools-support` will add the new team member to the [DFE-Digital organisation](https://github.com/orgs/DFE-Digital/teams). This needs to be requested through the [DFE Service Portal](https://dfe.service-now.com.mcas.ms/serviceportal?id=sc_cat_item&sys_id=0aacf3a81ba52110b192ec69b04bcb14) under `GitHub (dfe-digital) -> Add account`.
+
+We have three teams:
 * [teaching-vacancies-admins](https://github.com/orgs/DFE-Digital/teams/teaching-vacancies-admins)
 * [teaching-vacancies-developers](https://github.com/orgs/DFE-Digital/teams/teaching-vacancies-developers)
 * [teaching-vacancies-nondev](https://github.com/orgs/DFE-Digital/teams/teaching-vacancies-nondev)
 
 Plus
 * [Teacher Services Infrastructure](https://github.com/orgs/DFE-Digital/teams/teacher-services-infrastructure) who provide the DevOps function across Teacher Services
 
-The new developer will be added to [teaching-vacancies-developers](https://github.com/orgs/DFE-Digital/teams/teaching-vacancies-developers)
+One of TV developers needs to add the new developer to [teaching-vacancies-developers](https://github.com/orgs/DFE-Digital/teams/teaching-vacancies-developers) as `maintainer` role.
 
 ## DFE Azure Platform Identity
 
 You will need to request a Azure CID through the [Service Portal](https://dfe.service-now.com.mcas.ms/serviceportal?id=sc_cat_item&sys_id=51b0b9c5db1ff7809402e1aa4b96197d&referrer=recent_items) following [these instructions](https://technical-guidance.education.gov.uk/infrastructure/hosting/azure-cip/#onboarding-users).
 
-Request your Lead Developer/Team Lead to add you to the [s189 TV delivery team members list](https://portal.azure.com/#view/Microsoft_AAD_IAM/GroupDetailsMenuBlade/~/Members/groupId/30d11bf0-ab94-477a-bef4-82793788a7b7/menuId/).
+Request your Lead Developer/Team Lead to add you to the Azure [s189 TV delivery team members list](https://portal.azure.com/#view/Microsoft_AAD_IAM/GroupDirectMembersBlade/groupId/30d11bf0-ab94-477a-bef4-82793788a7b7). On their absence, this can be requested to be actioned by a member of the [#teacher-services-infra](https://ukgovernmentdfe.slack.com/archives/C011EM7HU85) team.
 
-Once having access, contact the Teacher Services Infrastructure team and request access to the following s189 subscriptions:
+Once having access, contact the [Teacher Services Infrastructure team](https://ukgovernmentdfe.slack.com/archives/C011EM7HU85) and request access to the following s189 subscriptions:
 
 * s189-teacher-services-cloud-development
 * s189-teacher-services-cloud-test
 * s189-teacher-services-cloud-production
 
+
+## GovUK Notify
+Ask a TV developer to add you to the [GovUK Notify team DfE Teaching Vacancies](https://www.notifications.service.gov.uk/services/786d369d-11d1-4c7e-9a11-ef06aab2978b/users/invite) team.
+
+New members will need this to be able to receive emails on testing environments.
+
 ## Sentry
 
-Developer will need to request access to our Sentry `teaching-vacancies` organisation through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal/).
+Developer will need to request access to our Sentry `teaching-vacancies` organisation through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal?id=sc_cat_item&sys_id=f350f8421b65a5104f999978b04bcb51&sysparm_category=7ed771041bc61150b192ec69b04bcb3e).
+
 ## Logit.io
 Developer will need to request access to Logit.io `TWD` account `Teaching Vacancies` stack for Kibana access.
 
-The access request can be raised through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal/)
+The access request can be raised through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal?id=sc_cat_item&sys_id=45717cc71b02e1904f999978b04bcb61)
 
 ## Status Cake
-Developer will need to request account access to Status Cake for `DfEStatusCake` workspace through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal/).
+Developer will need to request account access to Status Cake for `DfEStatusCake` workspace through the [DfE Service portal](https://dfe.service-now.com.mcas.ms/serviceportal?id=sc_cat_item&sys_id=e7a004df1b399c502fe864606e4bcb21).
+
 ## Zendesk
 
 Someone on the support team can add developers to Zendesk as and when needed (as there are limited seats available).
@@ -63,7 +73,6 @@ Someone on the support team can add developers to Zendesk as and when needed (as
 
 Any team member can invite the new developer to the following services:
 
-* [GOV.UK Notify](https://www.notifications.service.gov.uk/services/786d369d-11d1-4c7e-9a11-ef06aab2978b)
 * Skylight (Access through Github user with access to TV project).
 * Google Analytics
 * [Google Tag Manager](https://tagmanager.google.com/?authuser=2#/container/accounts/4702787029/containers/12903245/workspaces/103)