Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Onboarding Template - Jon Keister #17014

Closed
28 of 57 tasks
Tracked by #17244 ...
michelle-dooley opened this issue Jan 24, 2024 · 3 comments
Closed
28 of 57 tasks
Tracked by #17244 ...

Onboarding Template - Jon Keister #17014

michelle-dooley opened this issue Jan 24, 2024 · 3 comments
Assignees
Labels
CMS Team CMS Product team that manages both editor exp and devops

Comments

@michelle-dooley
Copy link
Collaborator

michelle-dooley commented Jan 24, 2024

Welcome to the VFS-CMS Team!

This ticket contains all of the onboarding activities for a new member joining the VFS-CMS Team. There's a lot to digest and the learning curve may take a few months, so we've organized the information in sections to help you pace yourself. Come back to this ticket any time to refresh your knowledge on a specific topic covered below. We look forward to getting to know you!

VFS-CMS Start Date:

Team info:

  • Onboarding buddy:
  • Product Owner: Erika Washburn
  • Delivery Manager:

(More CMS team info can be found in below in Day One section.)

Day one

Day one

  • Meet with your Delivery Manager for a brief orientation to the CMS Team.
  • Read about the CMS Team and see full team roster (link)
  • Read the VA's Office of the CTO (OCTO) engineering excellence guiding principles post in DSVA slack (link)
  • Read the VA.gov platform crew principals.
  • Open a VA.gov Platform orientation ticket.
    • The VA.gov Platform team manages VA.gov tooling and network access. In order to receive access to the SOCKS network proxy (described later), you must 1) create the Platform orientation ticket linked above, 2) have completed your e-QIP paperwork and receive/provide a screenshot of the email with your e-QIP transmittal date (your Delivery Manager will provide details on timing), 3) attend a Platform orientation.
    • These steps will result in getting you added to the VFS Platform roster.
    • If a Platform orientation isn't available for several weeks, sign up for the next available slot, then tag your Delivery Manager and VA Product Owner on your Platform ticket to expedite SOCKS access.
Week one

Week one

The goals of this week are:

  1. get background paperwork completed as quickly as possible and
  2. start gaining context for what we're doing and why.

VA security clearance / VA onboarding paperwork

Getting onboarded to the VA can take a few weeks to a few months. We encourage you to prioritize these tasks before any team tasks.

  • Wait to receive an email directing you to the paperwork you should fill out for secure access to relevant VA systems. Federal contractors are required to complete many of the same forms as federal employees. If you're not sure which you contract you are on, ask your Delivery Manager.
    • VFS-CMS contract paperwork will come from A6.
  • Complete and submit your initial paperwork per contract instructions, including setting up your fingerprinting appointment.
  • When you are notified to complete your e-QIP (the online version of the federal standard investigation form, SF 86), it will require a lot of background information. Review page 7 of the SF 86 guide in advance for the list of information you'll need to collect to complete e-QIP

Drupal Content Management System

Gaining product knowledge about the CMS can take some time. These activities can be completed in any order and are secondary to your VA security clearance onboarding tasks above.

Week two

Week two

What products do we support?

  • Read the product outlines in the repository for a non-inclusive view of the platform. Be mindful of the dates, as some of these products have not been shipped but may still live in our backlog.

Access

Regardless of your role, please review these access notes. Your Delivery Manager will have set up most of the tools for you (with the exception of SOCKS). This list is for you to verify along the way:

SOCKS - VA network proxy

The VA network is required for Drupal CMS and other VA tools and usually requires a VA ID card (PIV or Smartcard). Until you get your paperwork approved and ID card, SOCKS proxy is a back door to some of these tools. This is the first priority for week two.

  • File a SOCKS proxy request and select the label for your team. See SOCKS access for Jun Tao (John) Luo va.gov-team#68549
    • Platform orientation. This should have been requested on day one as part of the Platform onboarding ticket but is here as a reminder that this is a blocker for SOCKS access as you'll need to get added to their ecosystem roster in order to proceed.
  • Provide a screenshot of the email that confirms your eQip transmittal date. This is an acknowledgement that your paperwork is being processed from a security standpoint. You cannot receive SOCKS access prior to this point in your onboarding.
  • Request a Github personal access token first. You only need to do the "repo" panel in that form and leave the other panels as is. It may take a day or two for the SOCKS proxy request to be fulfilled before you can complete the rest of the SOCKS process. This can be a complex process. Post in #sitewide-program Slack channel if you need help from a current member - we're happy to help.

Github - for issue tracking and document sharing

Slack - for instant messaging

Your Delivery Manager should have already requested this for you, but if not, view the request instructions

  • Review Slack etiquette.
  • Update your profiles in Slack (in the A6 and DSVA workspaces), add a calendar link
  • Reach out to your Delivery Manager if you have questions about which appropriate Slack channels and user groups to join in the DSVA workspace

These are the initial Slack channels you'll be added to by your Delivery Manager:

  • In the A6/agency workspace = your team channel is#team-vfs-cms for general communication outside of our project work
  • In the DSVA workspace = your team channel is#sitewide-cms-platform for project-related communication and collaboration
  • This is a description of other channels to put on your radar. Note that many are going to be dependent on which workstream you're in.

Drupal - for logging into the CMS (SOCKS or VA access with PIV card required)

Drupal is the VA's content management system of choice. For anyone on our team, it's beneficial to have a CMS user account so you can login, look at settings, and understand how the CMS works at a high level. If you need help completing the technical steps here, schedule 30 mins with your Delivery Manager.

  • Learn about the different Drupal environments
  • Drupal production environment access (SOCKS or VA network required) - in DSVA #cms-support channel, use the Slack workflow to file a helpdesk support request. Ask the helpdesk to create a Drupal user for you in prod.cms.va.gov.
    • Product Managers should request an Administrator account.
    • DevOps team members require an administrator account. (SOCKS or VA access with PIV card required)
    • Standard practice for other roles is to have minimal access in prod (content editor or even a blocked account) and full admin access in lower environments.
Tugboat - for previewing in demo environments (SOCKS or VA access with PIV card required)

Tugboat is a development server platform where you can preview CMS code changes pre-production.

Other tools

  • Confluence (your Delivery Manager will get you added)
  • Datadog to access monitoring metrics (your Delivery Manager will get you added)
Discipline specific onboarding

For Developers

VA Platform documentation

Month one

Month one

By this point you should have enough context and access to be able to start contributing. Work with your team to identify specific issues to focus on.

Who?

  • Who are our VA points of contact? Discuss with your Delivery Manager or Product Owner.
  • Who should we know on the platform team? Who should we know on VFS Teams? Discuss with your Delivery Manager or Product Owner.

What?

@keisterj-oddball
Copy link
Collaborator

Done:

  • Got PIV Exemption
  • Able to access VA Email via CAG
  • Placed SOCKS access request

In Progress:

  • Waiting on SOCKS access

@gracekretschmer-metrostar

@keisterj-oddball have you received your PIV card yet?

@keisterj-oddball
Copy link
Collaborator

@gracekretschmer-metrostar just picked it up this morning. I'm waiting on my card reader to show up, but I do still have access via my PIV exemption until that arrives. I'll close this ticket, and refer back for any other onboarding/access things that arise moving forward.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CMS Team CMS Product team that manages both editor exp and devops
Projects
None yet
Development

No branches or pull requests

3 participants