Skip to content

Commit 959250d

Browse files
Merge pull request #547 from SuffolkLITLab/copilot/fix-521
Add First Wednesday workshops to relevant documentation pages
2 parents df8d68f + cf861bd commit 959250d

File tree

12 files changed

+109
-2
lines changed

12 files changed

+109
-2
lines changed

docs/authoring/docx_templates.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,8 @@ The syntax to type in fields in a DOCX template is named `jinja2`.
4848
[Learn more about Jinja2](https://suffolklitlab.org/legal-tech-class/docs/jinja2)
4949
and about [DOCX templates in Docassemble](https://docassemble.org/docs/documents.html#docx%20template%20file).
5050

51+
52+
5153
The most common kinds of fields you will use again and again
5254
are:
5355

docs/authoring/github.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,10 @@ We also shared this workflow in a Document Assembly Line workshop:
3939
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/4j7rRRvsbfY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
4040
</p>
4141

42+
:::info Workshop Resource
43+
📺 **First Wednesday Workshop:** For comprehensive coverage of GitHub workflows with Docassemble, watch our workshop on [The GitHub-Docassemble workflow](https://suffolklitlab.org/github-docassemble-workflow/). This session includes live demonstrations of branching, merging, and team development workflows specifically designed for Docassemble interview building.
44+
:::
45+
4246
## Collaboration
4347

4448
GitHub is built for collaboration, and tips for collaborating are included throughout this page, but here are some key highlights:

docs/authoring/pdf_templates.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ PDF](https://help.gavel.io/articles/automating-pdf-documents?query=pdf) with Gav
4545
<iframe width="560" height="315" src="https://youtube.com/embed/HHGTWJ4r2hk?start=83" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen alt="How to edit a PDF with Gavel's editor">
4646
</iframe>
4747

48+
4849
## Use limited field types
4950

5051
Use **only** these field types in your PDF document:

docs/authoring/weaver_overview.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ The steps that the Weaver will walk you through are as follows:
6161

6262
[Launch the Assembly Line Weaver](https://apps-dev.suffolklitlab.org/start/ALWeaver/assembly_line?new_session=1)
6363

64+
65+
6466
## Information you will be asked
6567

6668
To prepare to run your form through the Weaver, think about how you will answer

docs/coding_style/defense.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ sidebar_label: |
77
slug: defense
88
---
99

10+
:::info Workshop Resource
11+
📺 **First Wednesday Workshop:** For hands-on help with debugging and error resolution, watch our workshop on [Troubleshooting Docassemble interview errors](https://suffolklitlab.org/troubleshooting-docassemble-interview-errors-workshop/). This community Q&A session covers common error patterns, debugging strategies, and prevention techniques.
12+
:::
13+
1014
## Use Docassemble lists, dictionaries, and sets, or subclasses
1115

1216
Docassemble relies heavily on exceptions for its declarative logic

docs/coding_style/python.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@ sidebar_label: Python
55
slug: python
66
---
77

8+
:::info Workshop Resource
9+
📺 **First Wednesday Workshop:** For help understanding index variables and loop constructs in Docassemble, watch our workshop [Demystifying i and x in Docassemble](https://suffolklitlab.org/demystifying-i-and-x-in-docassemble/). This session clarifies common confusion around indexing and iteration patterns in Docassemble interviews.
10+
:::
11+
812
## Use Python conventions for Python code
913

1014
In general, we refer to Python's [PEP 8](https://www.python.org/dev/peps/pep-0008/) for all Python code.

docs/components/ALKiln/automated_testing.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ import { Anchor } from '/docs/react_components/\Anchor.js';
99

1010
<!-- slug: /alkiln_old_overview -->
1111

12+
:::info Workshop Resource
13+
📺 **First Wednesday Workshop:** For a comprehensive guide to implementing automated testing with ALKiln, watch our workshop [Building resilient Docassemble interviews with ALKiln automated testing](https://suffolklitlab.org/building-resilient-docassemble-interviews-with-alkiln-automated-testing/). This session covers test setup, best practices, and debugging techniques for robust interview development.
14+
:::
15+
1216
**Any docassemble package can use ALKiln**, though it does have special features created especially for projects using AssemblyLine. Give us feedback and propose ideas by making issues at https://github.com/SuffolkLITLab/ALKiln/issues.
1317

1418
🚧 Reference material for testing your interview with ALKiln. This is under very active development.

docs/get_started/beginners_guide.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,25 @@ You know enough to get started, but you will need help. The Document Assembly Li
6363

6464
You can also take advantage of other [interview building resources and documentation](resources.md).
6565

66+
<details>
67+
<summary>📺 Related First Wednesday Workshops</summary>
68+
69+
The Suffolk LIT Lab hosts monthly First Wednesday workshops covering topics relevant to building Docassemble interviews. These are informal, interactive sessions where you can ask questions and learn from the community.
70+
71+
**Workshop topics that may be helpful for beginners:**
72+
73+
- Getting Started with Docassemble
74+
- Introduction to the Document Assembly Line
75+
- Using the Assembly Line Weaver
76+
- Best Practices for Interview Design
77+
- Common Beginner Mistakes and How to Avoid Them
78+
79+
All workshops are recorded and available on our [workshop archive](https://suffolklitlab.org/tag/first-wednesday-workshops/). New workshops are held on the first Wednesday of each month at 3 PM Eastern.
80+
81+
[📅 View all workshops →](https://suffolklitlab.org/tag/first-wednesday-workshops/)
82+
83+
</details>
84+
6685
## Start building your first interview!
6786

6887
You probably already have an idea of the first form you want to work on, so pull up the [project management guide](project_management.md) and get started!

docs/get_started/intro.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,36 @@ You don't have to go it alone! We offer:
6767
* **Community forum.** The LIT Lab hosts a community forum for the Document Assembly Line in Microsoft Teams for general discussions, coding help, server admin, and more.
6868
* **First-Wednesday workshops.** On the first Wednesday of each month at 3pm Eastern we host online workshops where we go in-depth on topics requested by the community. These are informal sessions centered around questions from viewers. Our workshops are also streamed and archived on YouTube.
6969

70+
<details>
71+
<summary>📺 Explore Workshop Topics</summary>
72+
73+
Our monthly First Wednesday workshops cover a wide range of topics relevant to building court forms and guided interviews:
74+
75+
**Technical Topics:**
76+
- Docassemble fundamentals for beginners
77+
- Advanced interview logic and branching
78+
- Working with PDF and DOCX templates
79+
- Testing strategies and debugging techniques
80+
- API integrations and external services
81+
82+
**Design & User Experience:**
83+
- Creating accessible interviews
84+
- Mobile-first design principles
85+
- Writing clear, user-friendly questions
86+
- Usability testing for legal interviews
87+
88+
**Project Management:**
89+
- Planning and scoping interview projects
90+
- Working with stakeholders and courts
91+
- Version control and collaboration workflows
92+
- Launch strategies and user adoption
93+
94+
All sessions are recorded and archived for the community. Whether you're just getting started or looking to solve specific technical challenges, there's likely a workshop that addresses your needs.
95+
96+
[📚 Browse workshop archive →](https://suffolklitlab.org/tag/first-wednesday-workshops/)
97+
98+
</details>
99+
70100
To join the community, just [email us](mailto:[email protected])!
71101

72102
### Partner with the LIT Lab

docs/get_started/project_management.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,10 @@ After the kickoff through launch, the interview building team should hold regula
2929
If this is your first interview-building project, it may help to read more about [planning and building your first expert system](https://projects.suffolklitlab.org/legal-tech-class/docs/interview-structure/building-an-app-outline).
3030
:::
3131

32+
:::info Workshop Resource
33+
📺 **First Wednesday Workshop:** For comprehensive guidance on project management, team collaboration, and stakeholder communication in interview development, watch our workshop on [Interview project management](https://suffolklitlab.org/interview-project-management/). This session covers planning, scoping, launch strategies, and working effectively with courts and legal organizations.
34+
:::
35+
3236
### Kickoff {#kickoff}
3337

3438
Hold a kickoff meeting for the project as early as possible. Everyone who is important to the success of the project—the interview building team, the decisionmaker, and the key stakeholders—should attend.

0 commit comments

Comments
 (0)