Merge branch 'main' into update_readme

.adr-dir

@@ -0,0 +1 @@
+docs/architecture/decisions

docs/architecture/decisions/0006-remove-snyk-in-favor-of-dependabot.md

@@ -0,0 +1,37 @@
+# 6. Remove Snyk in favor of Dependabot
+
+Date: 2024-07-17
+
+## Status
+
+Accepted
+
+## Context
+
+Snyk, a security scanning tool, is being used to monitor for
+exploitable dependencies and notify us when they're found in
+our repository.
+
+Grype is another, similar tool that runs in a CI/CD also
+scans for dependency issues.  Unlike Snyk, Grype is an
+OSS tool (even though we were using a free tier of Snyk's
+otherwise paid service).
+
+Dependabot also scans for dependencies that need to be
+updated; however, it's configured to run on a periodic
+basis (e.g., weekly).  Therefore, even if a Pull Request
+(PR) isn't being considered, Dependabot will still run to
+look for dependencies that need to be updated and create
+PRs to include those updates.
+
+## Decision
+
+Remove Snyk in favor of Dependabot and Grype.
+
+## Consequences
+
+We have the best both worlds in that Grype runs when commits
+are pushed to PRs and Dependabot runs regularly even when
+there are no new commits to scan.  Vulnerability data
+aren't being sent to Snyk, nor are we dependent upon a
+commercial platform for dependency scanning.

docs/architecture/decisions/0007-synchronize-job-postings-from-talent-repo.md

@@ -9,10 +9,10 @@ Accepted
 ## Context
 
 Job postings from the
-[Talent team repository](https://github.com/18F/join.tts.gsa.gov) need to
-be posted on the new TTS website.  The best case outcome would minimize
-redundancy (i.e., duplicate postings, duplicate files, etc.), rework,
-and training.
+[Talent team repository](https://github.com/18F/join.tts.gsa.gov)
+need to be posted on the new TTS website.  The best case outcome would
+minimize redundancy (i.e., duplicate postings, duplicate files, etc.),
+rework, and training.
 
 ## Decision
 

pages/jointts/federal-job-posting.md

@@ -20,9 +20,7 @@ sidenav:
     href: /join/rolling-hiring/
 ---
 
-Understanding every section of a federal job posting can help you prepare the
-strongest possible application. Below, we’ll explain each section of a TTS job
-posting and what information to look for when crafting your application.
+Understanding every section of a federal job posting can help you prepare the strongest possible application. Below, we’ll explain each section of a TTS job posting and what information to look for when crafting your application.
 
 <aside class="usa-alert usa-alert-info">
   <div class="usa-alert-body">
@@ -35,159 +33,95 @@ posting and what information to look for when crafting your application.
 
 ## Job Title
 
-Most job openings at TTS have two job titles: a functional title similar to one
-you would find in the private sector and an official title from the role’s
-Position Description. For example, many staff members are officially “IT
-Specialists” though they fill roles from content design to front-end developer
-to account manager.
+Most job openings at TTS have two job titles: a functional title similar to one you would find in the private sector and an official title from the role’s Position Description. For example, many staff members are officially “IT Specialists” though they fill roles from content design to front-end developer to account manager.
 
-> **Take away:** Pay attention to the job title at the top, and don’t get
-> confused if there’s a different one on USAJOBS.gov.
+> **Take away:** Pay attention to the job title at the top and don’t get confused if there’s a different one on USAJOBS.gov.
 
 ## Role Summary
 
-This is the heart of the job posting. This section will include information
-about the skills we’re looking for in this job, what kind of work you’d be
-doing, and specific required technologies or programming languages. There will
-also be a list of three-five key objectives with bullet points describing the
-core responsibilities of the position.
+This is the heart of the job posting. This section will include information about the skills we’re looking for in this job, what kind of work you’d be doing, and specific required technologies or programming languages. There will also be a list of three-five key objectives with bullet points describing the core responsibilities of the position.
 
-> **Take away:** Look for a match to your skills and experience in this section,
-> and determine if you could fulfill the key objectives.
+> **Take away:** Look for a match to your skills and experience in this section and determine if you could fulfill the key objectives.
 
 ## Basic Information
 
-This section gets into some of the technical details of a federal job posting.
-Some of our job postings may not have all of the sections listed here. Here’s
-what to look for in each section:
+This section gets into some of the technical details of a federal job posting. Some of our job postings may not have all of the sections listed here. Here’s what to look for in each section:
 
 ### Job announcement number
 
-Applicants claiming veteran status will need this number to submit their
-veterans’ preference documents for positions that apply this preference. Other
-applicants will not need to use this number during the application process.
+Applicants claiming veteran status will need this number to submit their veterans’ preference documents for positions that apply this preference. Other applicants will not need to use this number during the application process.
 
 ### Opening and closing period for this job application
 
-Pay close attention to the closing date. TTS jobs often have application windows
-as short as five days. We can only review applications submitted during this
-time period.
+Pay close attention to the closing date. TTS jobs often have application windows as short as five days. We can only review applications submitted during this time period.
 
 ### Series & Grade
 
-These are two numbers that designate the
-[official job series](https://www.opm.gov/policy-data-oversight/classification-qualifications/classifying-general-schedule-positions/)
-and the General Schedule grade for this position. For example, “0301-15” would
-mean the position was in the 0301 Miscellaneous Administration and Program job
-series and would have a General Schedule grade of 15. Read below for more
-information on the General Schedule (GS).
+These are two numbers that designate the [official job series](https://www.opm.gov/policy-data-oversight/classification-qualifications/classifying-general-schedule-positions/) and the General Schedule grade for this position. For example, “0301-15” would mean the position was in the 0301 Miscellaneous Administration and Program job series and would have a General Schedule grade of 15. Read below for more information on the General Schedule (GS).
 
 ### Promotion Potential
 
-This is the highest possible GS grade you can be promoted to in this position.
-The GS scale goes from one to 15.
+This is the highest possible GS grade you can be promoted to in this position. The GS scale goes from one to 15.
 
 ### Salary Range
 
-This illustrates the base pay range for this position. The actual salary will be
-the base pay plus a locality pay determined by where you live. You can learn
-more about pay and the GS scale in the
-[Compensation and Benefits section](https://join.tts.gsa.gov/compensation-and-benefits/).
+This illustrates the base pay range for this position. The actual salary will be the base pay plus a locality pay determined by where you live. You can learn more about pay and the GS scale in the [Compensation and Benefits section](https://join.tts.gsa.gov/compensation-and-benefits/).
 
 ### Location
 
-This information tells you if this position requires you to be in commutable
-distance of a specific location, such as Washington, DC, or whether this is a
-100% virtual position, and you can work anywhere within the U.S.
+This information tells you if this position requires you to be in commutable distance of a specific location, such as Washington, DC, or whether this is a 100% virtual position, and you can work anywhere within the U.S.
 
 ### Number of vacancies
 
 The vacancies tell how many openings we have for this specific type of role.
 
 ### Supervisory status
 
-This status addresses whether the position includes official supervisory
-responsibilities.
+This status addresses whether the position includes official supervisory responsibilities.
 
 ### Travel requirement
 
-Travel is expressed in the percentage of time you’re likely to travel in the
-position.
+Travel is expressed in the percentage of time you’re likely to travel in the position.
 
 ### Who May Apply
 
-This section addresses the eligibility criteria for the position. For most TTS
-jobs, only United States citizens and nationals (residents of American Samoa and
-Swains Islands) are eligible.
+This section addresses the eligibility criteria for the position. For most TTS jobs, only United States citizens and nationals (residents of American Samoa and Swains Islands) are eligible.
 
 ### Security clearance
 
-All government positions require some level of background check. Most roles at
-TTS require a public trust position clearance. Learn more in the [Security and
-Onboarding section]({{'join/hiring-process.md#security-and-onboarding' | url }}).
+All government positions require some level of background check. Most roles at TTS require a public trust position clearance. Learn more in the [Security and Onboarding section]({{'join/hiring-process.md#security-and-onboarding' | url }}).
 
 ### Work Schedule
 
 All TTS positions are full time, which equates to 40 hours per week.
 
 ### Appointment Type
 
-TTS hires staff into a couple different types of positions. Some have a maximum
-term of four or eight years, and some are permanent opportunities, so make sure
-to pay attention to what type of position for which you are applying.
+TTS hires staff into a couple different types of positions. Some have a maximum term of four or eight years, and some are permanent opportunities, so make sure to pay attention to what type of position for which you are applying.
 
 ## Job Summary
 
-This is the official job summary attached to the official job title. It’s a
-broader and more formal version of the Role Summary that’s standard across all
-job titles. This section includes a list of GSA employment benefits and will
-likely contain fewer details about the the position than the Role Summary
-section.
+This is the official job summary attached to the official job title. It’s a broader and more formal version of the Role Summary that’s standard across all job titles. This section includes a list of GSA employment benefits and will likely contain fewer details about the the position than the Role Summary section.
 
-> **Take away:** This section is helpful, but it’s best to use information from
-> other sections to determine what to include in your application.
+> **Take away:** This section is helpful, but it’s best to use information from other sections to determine what to include in your application.
 
 ## Key Requirements and Employment Requirements
 
-These two sections contain required information and language that is consistent
-across most TTS positions. They reiterate eligibility, application, and
-employment requirements.
+These two sections contain required information and language that is consistent across most TTS positions. They reiterate eligibility, application, and employment requirements.
 
 ## Duties
 
-This section is found on the USAJOBS.gov application page. This is another
-required section that expands on the official summary for the official job title
-of the position. The duties in this section will likely be broad and apply to a
-number of different job types. Please rely on the information in the Role
-Summary section and not the duties section to learn more about the particular
-position.
+This section is found on the USAJOBS.gov application page. This is another required section that expands on the official summary for the official job title of the position. The duties in this section will likely be broad and apply to a number of different job types. Please rely on the information in the Role Summary section and not the duties section to learn more about the particular position.
 
 ## Qualifications
 
-This section has critical information that must be present in your resume for
-you to advance through the application process. Read this section carefully. If
-you have the special qualifications listed, make sure they are explicitly
-included in your resume.
-
-The people evaluating your resume are not allowed to make any assumptions or
-review anything other than your resume (such as a portfolio or website) to
-determine if you meet the specialized experience criteria. You must include
-everything you want considered in your resume. In addition, the resume reviewer
-must be able to see you performed a certain task or skill for at least a full
-year in a full time position or an equivalent number of hours (e.g. 2 years at
-20 hours a week). If you list a specialized experience skill under only one job,
-and the job only lasted six months, it will not qualify you to meet the
-specialized experience qualifications. It is imperative that you include the
-months and years for the positions you have held so that your experience can be
-qualified.
+This section has critical information that must be present in your resume for you to advance through the application process. Read this section carefully. If you have the special qualifications listed, make sure they are explicitly included in your resume.
+
+The people evaluating your resume are not allowed to make any assumptions or review anything other than your resume (such as a portfolio or website) to determine if you meet the specialized experience criteria. You must include everything you want considered in your resume. In addition, the resume reviewer must be able to see you performed a certain task or skill for at least a full year in a full time position or an equivalent number of hours (e.g. 2 years at 20 hours a week). If you list a specialized experience skill under only one job, and the job only lasted six months, it will not qualify you to meet the specialized experience qualifications. It is imperative that you include the months and years for the positions you have held so that your experience can be qualified.
 
 > **Take away:** Use this section to carefully write your resume for
-> consideration for a TTS position. Make sure to include relevant language, so
-> it is obvious how you meet the qualification criteria.
+> consideration for a TTS position. Make sure to include relevant language, so it is obvious how you meet the qualification criteria.
 
 ## How To Apply
 
-This section includes information about the documents required for your
-application and a link to submit your application. If you’re claiming veterans’
-preference, this section will list the specific documentation you’ll need to
-provide.
+This section includes information about the documents required for your application and a link to submit your application. If you’re claiming veterans’ preference, this section will list the specific documentation you’ll need to provide.