"Weaving" your form into a draft interview
After your document is fully labeled, the next step is to automate a draft in the Document Assembly Line Weaver (ALWeaver).
The Assembly Line Weaver is a tool that helps you create a draft of a guided interview. You should not spend very much of your time at this stage.
Use the Weaver to:
- make sure you are using Assembly Line conventions
- get draft text in the right place, so you can easily find and edit it later
- get a runnable prototype so that you can start getting expert feedback
We designed the Weaver to produce clean, maintainable code. We do not intend it to work the way that fully no-code solutions work, which often are easy to use for simple features but produce code that is challenging to edit manually.
Limits of the Weaver
The Assembly Line Weaver does allow you to reorder screens. However: you will not be able to add any logic in the Weaver process.
This is by design. We want you to quickly get to the Docassemble playground to continue editing your code.
What the Weaver does
The steps that the Weaver will walk you through are as follows:
- validate the labels and your template file
- add some basic information about your form (follow the planning your interview to get this ready)
- add on-screen prompts for each labeled field
- choose a datatype for each labeled field (for example: text, number, date)
- organize the fields onto individual screens with headings and optional additional text
- download a completed, runnable draft interview
Launch the Assembly Line Weaver
Information you will be asked
To prepare to run your form through the Weaver, think about how you will answer the questions listed below:
- a short label for your form that is used to build unique variable names, like:
- a title for your interview
- a short description
- draft text that orients your user to what they need before they start working on your form
- whether the user is usually the plaintiff, defendant or could play either role
- the names of authors of your interview (usually, just you!)
- the country and state the form is from
- the category for your form
- the step in a court process that your form is filed: e.g., starting a case, filed as an appeal
- the list of courts your form can be filed in
- the total number of each kind of "person" that can appear on the form. e.g., can multiple plaintiffs file at once, or just one?
New features are regularly added to the Weaver, so the exact list of questions you will be asked may change.
Download your interview at the end
When you have finished using the Weaver, download your package. This will put a .zip file in the Downloads folder on your computer.
Next, upload this file to the Docassemble playground's
Safari, by default, will turn your downloaded package into a folder on your PC.
Before downloading the package, turn off that behavior:
- open Safari
- click Preferences
- under the General tab, uncheck the option Open 'safe' files after downloading
Example of a page in a Docassemble interview
A page might look like this:
You can see the ALWeaver docassemble package on GitHub