Update the volunteer signup page

docs/get_started/resources.mdx

@@ -1,21 +1,24 @@
 ---
 id: resources
-title: Resources
-sidebar_label: Resources
+title: Community resources
+sidebar_label: Community resources
 slug: resources
 ---
 
+import { Button } from '/docs/react_components/Button.jsx';
 import { VolunteerFormLink } from '/docs/react_components/VolunteerFormLink.jsx';
 
-As you are building interviews, use these resources to find answers to your questions, solve problems you run into, and get help.
+Use these resources to find answers to your questions, solve problems you run into, and get help.
 
 ## Community hub
 
 Microsoft Teams is our community hub. You can find channels for general communication, coding help, governance, off-topic chat, and more. To join the Document Assembly Line in Teams, just [email us](mailto:litlab@suffolk.edu?subject=Request%20to%20join%20Teams)!
 
 If you've already joined us in Teams:
 
-<a className="button button--primary" href="https://teams.microsoft.com/l/team/19%3A8b0fa1d62a014c7d9c27b69939e38644%40thread.tacv2/conversations?groupId=eaa9bd9d-cf39-4686-8f30-e55aa9d98c75&tenantId=78733fa9-540e-4eb8-bf29-73c4eeb63412" style={{fontWeight: "normal", textDecoration: "none"}} target="_blank">Go to Teams</a>
+<Button 
+	href="https://teams.microsoft.com/l/team/19%3A8b0fa1d62a014c7d9c27b69939e38644%40thread.tacv2/conversations?groupId=eaa9bd9d-cf39-4686-8f30-e55aa9d98c75&tenantId=78733fa9-540e-4eb8-bf29-73c4eeb63412"
+>Go to Teams</Button>
 
 ## Interview building resources
 

docs/react_components/Button.jsx

@@ -0,0 +1,29 @@
+export function Button({
+  href,
+  className = "button button--primary",
+  children,
+  style = {},
+  ...otherProps
+}) {
+  /**
+   * A reusable button component for styling links as buttons.
+   *
+   * @param {string} href - The URL to navigate to
+   * @param {string} [className] - CSS classes (defaults to "button button--primary")
+   * @param {React} children - Button text or content
+   * @param {object} [style] - Inline styles (can override default fontWeight and textDecoration)
+   * @param {object} [otherProps] - Additional HTML attributes
+   *
+   * @returns {React} - An anchor element styled as a button
+   */
+  return (
+		<a
+			href={href}
+			className={className}
+			style={{ fontWeight: "normal", textDecoration: "none", ...style }}
+			{...otherProps}
+		>
+			{children}
+		</a>
+  );
+}

docs/react_components/VolunteerFormLink.jsx

@@ -1,5 +1,5 @@
 import { useLocation } from '@docusaurus/router';
-
+import { Button } from '/docs/react_components/Button.jsx';
 
 export function VolunteerFormLink( props ) {
   /**
@@ -11,28 +11,18 @@ export function VolunteerFormLink( props ) {
   const urlParams = new URLSearchParams( search );
   const source = props.source || urlParams.get(`source`);
 
-  let sign_up_text = `Sign up to express your interest`
-  if ( source ) {
-    sign_up_text = `Sign up to volunteer`
-  }
-
+  let sign_up_text = `Sign up to volunteer`
+
   return (
     <p>
-      <a
-        className={`button button--primary ${ props.className }`}
-        target="_blank"
-        // disabled={ props.disabled }
-        style={{
-          "--ifm-button-size-multiplier": "1.25",
-          fontWeight: "normal",
-          textDecoration: "none"
-        }}
+      <Button
         href={
           `https://apps.suffolklitlab.org/interview?i=docassemble.DALVolunteerSignup:main.yml&source=${ source || 'docs' }`
         }
+        style={{ "--ifm-button-size-multiplier": "1.25" }}
       >
         { sign_up_text }
-      </a>
+      </Button>
     </p>
   )
 

docs/volunteer/volunteer.mdx

@@ -1,83 +1,90 @@
 ---
 id: sign_up
-title: Sign up to volunteer
+title: Volunteer with the Document Assembly Line
 sidebar_label: Sign up
 slug: sign_up
 ---
 
 import { VolunteerFormLink } from '/docs/react_components/VolunteerFormLink.jsx';
 
-Welcome!
+<!--
+Decisions:
+- 2025-03-12: The only named crews will be those that need specialized knowledge.
+-->
 
-The Document Assembly Line volunteer program aims to train and organize volunteers to build, translate, verify, and maintain digital guided forms that everyday people can use to fill out critical legal forms online. You can see some of these on [Court Forms Online](https://courtformsonline.org/). We would love your help!
+Document Assembly Line volunteers help solve legal problems at scale by building and improving the online guided interviews on [Court Forms Online](https://courtformsonline.org/). It's a big job, and we need lawyers, coders, native language speakers, organizers, and others to do it.
 
-<VolunteerFormLink/>
+We would love your help! If you are interested in volunteering with the Document Assembly Line, fill out the [volunteer signup form](https://apps.suffolklitlab.org/interview?i=docassemble.DALVolunteerSignup:main.yml&source=docs) and we will follow up as soon as we can.
 
-## Context
+<VolunteerFormLink/>
 
-Since before COVID‑19, all over the US, many people have not been able to get to critical court services or legal help. For example, parents who need to leave home for various reasons need specific forms and processes to set up legally supported access to medical care or schools for their children through family or community members.
+## Background
 
-Digital forms—online guided interviews—are a proven way to bridge that gap for many, helping clarify forms and processes with access from home, yet those digital forms remain scarce. During COVID-19 this project, the Document Assembly Line (DAL) at [Suffolk LIT Lab](https://suffolklitlab.org/), in Massachusetts, ran a massive volunteer effort, and now partners with courts and organizations in [numerous states](https://courtformsonline.org/) to provide free online forms. We are currently looking to grow our new volunteer initiative to increase our reach across the US.
+Online guided interviews are a key tool for bridging the access-to-justice gap. They empower people to complete and file essential court forms on their own, from a smartphone or computer.
 
-:::info[**Current initiative**]
-## Remote administration and logistics volunteer opportunities
+Here's just one example: during the COVID pandemic a tenant used Court Forms Online to reverse an eviction in progress. While the sheriff was removing furniture and other belongings from their apartment, the tenant used Court Forms Online to complete and file a [motion to stay the eviction](https://courtformsonline.org/ma/forms/appeal-or-stay-your-eviction) from their phone. The court granted the motion the same day, and the sheriff put the tenant's property back!
 
-⭐️ [Sign up to express your interest here](https://apps.suffolklitlab.org/interview?i=docassemble.DALVolunteerSignup:main.yml&source=docsblurbstart).
+There are many other situations where guided interviews can make a difference by empowering people who many not have access to any other legal help:
 
-**Objective**: We are starting a new volunteer push to help people in under-served communities across the United States obtain the legal protection they need, even when they cannot reach a courthouse.
+- Housing
+- Domestic violence
+- Child custody
+- Debt collection
+- Public benefits
+- Guardianship
+- Immigration
+- General court procedures
+- Etc.
 
-*At this stage we are assessing the feasibility of expanding our new volunteer program, and organizers are a crucial piece of the puzzle. This journey will require organizational stamina and that is why we are starting with our organizers.*
+The free guided interviews on Court Forms Online are built by students, courts, legal aid organizations, and volunteers across the US. But building, expanding, and maintaining such a large collection of forms is a lot of work! Some have bugs or need updates due to changes in the law, procedures, or official court forms. Some need to be translated. Most could be improved.
 
-**Volunteer organizer role**:
-We need people who can coordinate and steadily grow a volunteer base that builds, translates, tests, and maintains online legal forms. As a team, we are looking for people who can communicate well, work independently, track progress, and assess strengths and obstacles. We will need some volunteers to have comfort with one or more of the following tools: email, Zoom, Microsoft Teams, Slack, project boards, spreadsheets, and GitHub. Your work will shape how we roll out the program and keep it responsive to state‑specific needs.
+Our goal is to train and organize volunteers to help us do that work. In exchange, we'll teach you to work with cutting-edge legal technology like Docassemble and artificial intelligence. Sound like something you'd like to be a part of?
 
-⭐️ [Sign up to express your interest here](https://apps.suffolklitlab.org/interview?i=docassemble.DALVolunteerSignup:main.yml&source=docsblurbend).
-:::
+<VolunteerFormLink/>
 
 ## Volunteer opportunities
 
-You can join one or more of several volunteer teams:
+When you fill out the signup form you'll be asked to indicate which volunteer opportunities you are most interested in.
 
-<!--
-META docs:
-- Decision 2025-03-12: The only named crews will be those that need specialized knowledge.
-- Decision 2025-03-12: (Grammar) Use colons to separate terms and definitions as per https://owl.purdue.edu/owl/research_and_citation/using_research/writing_with_statistics/key_terms.html
--->
-
-* **[Organize volunteers](#volunteer_organizers)**: Strengthen our volunteer organizing efforts.
-* **[Legal subject matter experts](#smes)**: From state-specific legal experts to law students, folks from the community who can make sure our forms are legally accurate.
-* **[Build and update forms](#builders)**: Help us make new forms and work through our backlog of interview improvements and updates to take our existing forms to the next level.
+* **[Organizers](#organizers)**: Help organize our volunteer efforts!
+* **[Builders](#builders)**: Help us build new forms and work through our maintenance and improvement backlog.
+* **[Subject-matter experts](#smes)**: Legal experts who can review guided interviews for legal accuracy.
 * **[Translators](#translators)**: Review translations for accuracy.
-* **[Other roles](#other)**: We need to bring many skills and perspectives to the table to reach our goals.
-    - Local community organizers for the communities we are trying to serve.
-    - Usability testers give us feedback on our forms.
-    - Bug hunters test interviews for bugs.
-    - Data verifiers verify that information, like courthouse addresses, are up to date.
-    - Plain language wizards.
-    - Documentation writers.
-    - Copy editors.
-    - Everything else!
+* **[Other](#other)**
+
+All volunteer work is done remotely, and all training, meetings, and communication happen online. Volunteers should be comfortable with (or willing to learn) the following tools:
 
-All volunteer work is done remotely, and all training, meetings, and communication happen online, via Zoom, Microsoft Teams, and GitHub.
+- Microsoft Teams
+- Zoom
+- Email
 
-### Volunteer organizers {#volunteer_organizers}
+We don't require a certain number of hours. You decide how much time you can commit to volunteering. We just ask that you check in regularly.
 
-We plan for the volunteer organizing team to recruit, onboard, coordinate, and assess strengths and obstacles for the volunteer program. We could use folks with good communication and coordination skills, the ability to work independently, and the ability to track status and progress of projects and volunteers. In addition, we will need some volunteers to have comfort with one or more of the following tools: Email, Zoom, Microsoft Teams, Slack, project boards, spreadsheets, and GitHub.
+### Organizers {#organizers}
 
-Volunteer organizing is an ongoing project and you can participate when you are able. We also encourage you to think about how this role fits with your current commitments.
+Document Assembly Line volunteers are largely self-organized, with support from Suffolk LIT Lab staff. Volunteer organizers manage volunteer recruiting, intake and onboarding, training, project management, and everything else related to volunteer work.
 
-### Legal subject matter experts {#smes}
+We need volunteers who can work independently but check in regularly, have good communication and coordination skills, and are able to keep track of projects and volunteers to keep things moving forward.
 
-A couple of levels of legal experience can be useful here. We need some with deep knowledge who can review our forms to make sure we are apply the law correctly, especially for state-specific and legal-area-specific forms. We could also use those who can do crucial work that takes less expertise, such as checking whether our forms are up to date with the latest versions of the current court PDFs.
+In addition to the tools above, organizers may need to work with spreadsheets, project boards, and GitHub.
 
-Lending your expertise is on a per-participant and per-form basis. We can spread the work among those available and will continue to actively seek out more help. As far as reviews go, the time for each review will depend on the complexity of the form and there usually need to be several rounds of review/edits, but they can be spread out over time and among volunteers.
+### Subject matter experts (SMEs) {#smes}
+
+In order to make sure our forms and interviews are legally correct, we need:
+
+- People with deep knowledge of specific areas of law and procedure (e.g., experienced lawyers and legal professionals)
+- People with general legal knowledge who can figure out if laws, procedures, or official forms have changed (e.g., law students and legal staff)
+
+You can work on one interview or many, depending on the time you can contribute and the depth of your subject-matter knowledge. The overall time depends on the complexity of the form, and usually includes a few rounds of feedback and updates that involve other volunteers.
 
 ### Builders
 
-Update interviews from a backlog of tasks. This involves coding in Docassemble, but **no coding experience is necessary to join this team**. We will teach you everything you need to get started and support you with regular check-ins. You just need to be willing to learn!
+Build and update online guided interviews! This involves coding in Docassemble, but **no coding experience is necessary to join this team**. We will teach you everything you need to get started and support you with regular check-ins. You just need to be willing to learn!
 
 Building interviews is an ongoing project, and the updates team requires a long-term commitment. Volunteers should be able to commit at least 5–10 hours per month for at least 3 months.
 
+In addition to the tools above, builders will need to work with Docassemble and GitHub (but we'll teach you what you need to know).
+
 ### Translators
 
 Review draft translations for accuracy to help make interviews more accessible. The translation team primarily needs native speakers to ensure clear translations.
@@ -86,34 +93,23 @@ We ask for translation volunteers as needed, by notifying the translation team v
 
 ### Other
 
-It would be impossible to list all the types of support these kinds of projects need. If you have other experience or skills to contribute, we would love to hear from you! Examples include:
+It would be impossible to list all the types of support we need. If you want to volunteer but aren't sure how, we would love to hear from you!
 
-- Local community organizers for the communities we are trying to serve.
-- Usability testers give us feedback on our forms.
-- Bug hunters test interviews for bugs.
-- Data verifiers verify that information, like courthouse addresses, are up to date.
-- Plain language wizards.
-- Documentation writers.
-- Copy editors.
-- You!
+Here are some examples of other ways to volunteer:
 
-## Expectations
-
-We expect volunteers who are actively training or working on a project to check in regularly. In general, check-ins are brief. They are usually Zoom meetings, but in some cases we may use asynchronous updates in Teams.
+  - Bug hunters to test and document issues
+  - Copy editors and plain-language wizards
+  - Data validators
+  - Documentation writers
+  - Local community organizers
+  - Usability testers to give feedback and document issues
 
-The purpose of check-ins is to keep the project on track by sharing your progress, plan, and questions or blockers with your team:
+And more! Whatever your skills and interests, we can probably put them to good use!
 
-1. **Progress.** What did you do last week?
-2. **Plan.** What are you going to do this week?
-3. **Questions/blockers.** Is anything preventing you from making progress?<br />
-  Blockers can include questions, tech support issues, uncooperative third parties, etc. We often address questions and blockers live during meetings, or we can follow up later.
-
-Also, let us know if you need something else to work on.
+## Expectations
 
-## Sign up to volunteer
+We expect volunteers who are actively training or working on a project to check in regularly. We generally check in weekly by responding to a post in Teams with a status update. (This is also a regular reminder to let us know if you need something else to work on!)
 
-:::info
-Thanks for the great response! We are now focusing on the "volunteer organizing" team to help expand the program. For all other roles, you can still submit the form and we will reach out when we can take on more volunteers in those positions.
-:::
+## Ready? Sign up to volunteer
 
 <VolunteerFormLink/>

sidebars.js

@@ -18,21 +18,29 @@ module.exports = {
             ],
         },
         'get_started/resources',
-        {
-            "type": "link",
-            "label": "Developer documentation",
-            "href": "/docs/overview",
-            "description": "View developer documentation"
-        },
         {
             label: 'Volunteer',
+            collapsed: false,
             type: 'category',
             items: [
                 'volunteer/sign_up',
+                {
+                    "type": "link",
+                    "label": "Resources",
+                    "href": "/docs/get_started/resources#volunteer-resources",
+                    "description": "Volunteer resources"
+                },
                 'volunteer/volunteer_flows',
             ]
         },
         'get_started/development_roadmap',
+        'get_started/community_practices',
+        {
+            "type": "link",
+            "label": "Developer docs",
+            "href": "/docs/overview",
+            "description": "Go to developer documentation"
+        },
         'contributors',
         {
             label: 'Archived pages',
@@ -42,7 +50,6 @@ module.exports = {
                 'archive/working_with_teams',
             ],
         },
-        'get_started/community_practices',
     ],
     docs: [
         'overview',