Skip to content

Commit ab987ae

Browse files
Add comprehensive landing page guidance documentation
Co-authored-by: nonprofittechy <7645641+nonprofittechy@users.noreply.github.com>
1 parent b2221fb commit ab987ae

File tree

5 files changed

+173
-3
lines changed

5 files changed

+173
-3
lines changed

docs/authoring/github.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ GitHub can't help you if you don't use it, so **commit early and often**!
138138
2. On the **Packages** screen, review the following fields and update them if necessary:
139139
1. **Author name and email.** These will be included in the public README file. Consider using your organization's name and email, instead.
140140
2. **Description.** Change the default to something that actually describes the interview. For example: "A Docassemble interview for a Massachusetts 209A Protection from Abuse Order."
141-
3. **URL.** If the interview is live, use the landing-page URL.
141+
3. **URL.** If the interview is live, use the landing-page URL. Learn more about [creating effective landing pages](landing_pages.md).
142142
4. **Interview, template, static, and source files.** Only selected files will be uploaded to GitHub. (Hold Control on Windows or Command on macOS while you click to select multiple files.)
143143
5. **README.** Add information for future developers.
144144
3. Scroll to the bottom of the page and click on the **GitHub** button

docs/authoring/landing_pages.md

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
---
2+
id: landing_pages
3+
title: Creating effective landing pages for interviews
4+
sidebar_label: Landing pages
5+
---
6+
7+
A landing page is a dedicated web page that introduces your guided interview and provides essential context before users begin. Landing pages are crucial for user success and should always be shared instead of direct interview links.
8+
9+
## Why landing pages matter
10+
11+
**For users:**
12+
- Provides context about what the interview will do and what they'll need
13+
- Sets proper expectations about time requirements and outcomes
14+
- Offers an opportunity to determine if the tool is right for their situation
15+
- Reduces abandonment rates and user frustration
16+
17+
**For organizations:**
18+
- Improves search engine optimization (SEO) and discoverability
19+
- Provides better analytics and tracking capabilities
20+
- Allows for easier updates and maintenance
21+
- Creates opportunities for additional resources and support information
22+
23+
## Essential elements of a landing page
24+
25+
### Clear, descriptive title
26+
Use language that matches how people search for help with their legal problem, not just the official form name.
27+
28+
**Instead of:** "Massachusetts Complaint for Protection from Abuse (209A)"
29+
**Try:** "Get a restraining order in Massachusetts"
30+
31+
### Brief, scannable description
32+
Most users won't read lengthy explanations. Focus on the most important information:
33+
34+
- What legal problem this solves
35+
- Who it's for (and who it's not for)
36+
- What the end result will be
37+
- Estimated time to complete
38+
39+
### Prerequisites and requirements
40+
Help users determine if they're ready to start by listing:
41+
42+
- Information they'll need to gather
43+
- Documents they should have available
44+
- Eligibility requirements
45+
- Any court filing fees or other costs
46+
47+
### What happens after completion
48+
Users need to know their next steps:
49+
50+
- How they'll receive their completed forms
51+
- Where and how to file documents
52+
- What to expect in court
53+
- Additional resources for follow-up help
54+
55+
## Best practices for landing page content
56+
57+
### Focus on just-in-time information
58+
Since users often skip detailed reading, prioritize information they absolutely need before starting. Save detailed explanations for help text within the interview itself.
59+
60+
### Use plain language
61+
- Write at an 8th-grade reading level or lower
62+
- Avoid legal jargon and technical terms
63+
- Define necessary legal terms clearly
64+
- Use active voice and short sentences
65+
66+
### Make it scannable
67+
- Use bullet points and short paragraphs
68+
- Include clear headings and subheadings
69+
- Highlight key information visually
70+
- Consider using icons or graphics to break up text
71+
72+
### Address common concerns
73+
Anticipate and address frequent user questions:
74+
75+
- "Is this the right form for my situation?"
76+
- "How long will this take?"
77+
- "What if I make a mistake?"
78+
- "Is my information secure?"
79+
80+
## SEO optimization for landing pages
81+
82+
A well-optimized landing page helps people find your interview through search engines. This complements the broader [SEO strategies](../get_started/search_engine_optimization.md) for legal help websites.
83+
84+
### Target user search terms
85+
Research how people actually search for help with this legal issue:
86+
87+
- Use tools like Google's "People also ask" suggestions
88+
- Check related search terms at the bottom of Google results
89+
- Consider variations in terminology (legal vs. common language)
90+
- Think about urgent vs. planning-ahead searches
91+
92+
### Optimize key elements
93+
- **Page title:** Include primary keywords users search for
94+
- **Meta description:** Summarize the page in 150-160 characters
95+
- **Headings:** Use H1, H2, H3 tags with relevant keywords
96+
- **URL:** Keep it short and descriptive
97+
98+
### Create quality content
99+
Search engines prioritize helpful, comprehensive content:
100+
101+
- Answer the questions users are actually asking
102+
- Provide value beyond just linking to the interview
103+
- Include relevant local information when applicable
104+
- Link to related resources and official sources
105+
106+
## Integration with project workflow
107+
108+
### During development
109+
Include landing page creation in your interview development process:
110+
111+
1. Draft landing page content alongside interview planning
112+
2. Test the landing page with potential users
113+
3. Refine based on user feedback and common questions
114+
4. Ensure consistency between landing page and interview flow
115+
116+
### After launch
117+
- Monitor user behavior and feedback
118+
- Update content based on frequently asked questions
119+
- Keep information current as laws or procedures change
120+
- Track performance through analytics
121+
122+
### Promotion and sharing
123+
Always share the landing page URL, not the direct interview link:
124+
125+
- When working with partner organizations
126+
- In presentations and educational materials
127+
- On social media and in newsletters
128+
- When speaking with journalists or other media
129+
130+
## Examples of effective elements
131+
132+
### Clear call-to-action
133+
**Good:** "Start your restraining order application now"
134+
**Better:** "Get help filing for a restraining order - Start here"
135+
136+
### Realistic time estimates
137+
**Vague:** "This will take a few minutes"
138+
**Specific:** "Most people complete this in 15-20 minutes"
139+
140+
### Helpful warnings
141+
**Generic:** "Make sure you have all required information"
142+
**Specific:** "You'll need the other person's full name and address. If you don't have their address, that's okay - you can still file."
143+
144+
## Common mistakes to avoid
145+
146+
- **Too much information:** Overwhelming users with every possible detail
147+
- **Legal language:** Using terminology that users don't understand
148+
- **Missing context:** Not explaining what the interview actually does
149+
- **No next steps:** Leaving users unsure what happens after completion
150+
- **Outdated information:** Not maintaining currency with law changes
151+
- **Direct interview links:** Bypassing the landing page entirely
152+
153+
## Measuring success
154+
155+
Track these metrics to evaluate your landing page effectiveness:
156+
157+
- **Conversion rate:** Percentage of landing page visitors who start the interview
158+
- **Completion rate:** Percentage who finish after starting
159+
- **Time on page:** How long users spend reading before deciding
160+
- **Bounce rate:** Percentage who leave without taking action
161+
- **User feedback:** Comments and questions about clarity and usefulness
162+
163+
## Resources and tools
164+
165+
- [SEO basics for legal help pages](../get_started/search_engine_optimization.md)
166+
- [Writing good questions style guide](../style_guide/question_style_overview.md)
167+
- [Project management workflow](../get_started/project_management.md)
168+
- [Plain language guidelines](https://www.plainlanguage.gov/)
169+
- [Hemingway Editor](https://hemingwayapp.com/) for readability testing

docs/get_started/project_management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ When you are ready to launch, add the interview to your production server and ma
262262

263263
Once the interview is live, consider how people who need it will find it.
264264

265-
* You should have a dedicated page on your website that tells people about the interview and links to it. [Optimize the page for search engines](search_engine_optimization.md), too!
265+
* You should have a dedicated page on your website that tells people about the interview and links to it. Learn more about [creating effective landing pages](../authoring/landing_pages.md) and [optimizing them for search engines](search_engine_optimization.md).
266266
* Others might want to direct people to the interview, like courts, legal aid organizations, and other advocates. Ask them to link to your landing page from their own websites.
267267
* Paid advertising can help spread awareness, if you have a budget for it.
268268

docs/style_guide/question_style_structure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ In addition the content in the interview itself, a guided interview should also
112112
have:
113113

114114
1. a landing page that gives users context before they click a link to start the
115-
interview
115+
interview. Learn more about [creating effective landing pages](../authoring/landing_pages.md).
116116
1. help at appropriate points inside the interview that allows users to answer
117117
questions with confidence
118118
1. a document they can print and take with them that tells them what to do after

sidebars.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@ module.exports = {
4242
items: [
4343
'authoring/pdf_templates',
4444
'authoring/docx_templates',
45+
'authoring/landing_pages',
4546
'authoring/dynamic_phrasing_based_on_values',
4647
'authoring/document_variables_reference',
4748
'authoring/name_formats',

0 commit comments

Comments
 (0)