You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/authoring/customizing_interview.md
+17-23Lines changed: 17 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -443,17 +443,10 @@ A more complete guide to [helping your user](../coding_style/yaml_interface.md#a
443
443
Here are a few reasons that a question may be getting
444
444
asked that you did not expect:
445
445
446
-
1. You may have referenced a built-in question from the
447
-
question library.
448
-
1. The question might be needed to ask another question,
449
-
such as a name to personalize a question, or an address
450
-
to locate a court.
451
-
1. You may have made a typo or mistake with your variable
452
-
names, and ended up asking something that is also defined
453
-
by an Assembly Line question. This could lead to 2 or more
454
-
very similar questions.
455
-
1. You might not have defined something, like the party roles,
456
-
that your interview now needs to know in order to make sense.
446
+
1. You may have referenced a built-in question from the question library.
447
+
2. The question might be needed to ask another question, such as a name to personalize a question, or an address to locate a court.
448
+
3. You may have made a typo or mistake with your variable names, and ended up asking something that is also defined by an Assembly Line question. This could lead to 2 or more very similar questions.
449
+
4. You might not have defined something, like the party roles, that your interview now needs to know in order to make sense.
457
450
458
451
### Understanding the question library
459
452
@@ -484,9 +477,7 @@ Here's how:
484
477
485
478
486
479
:::note About `generic object`
487
-
The [`generic object`](https://docassemble.org/docs/modifiers.html#generic%20object) modifier is a special way to make
488
-
one question work for many different objects, like people
489
-
or lists of people.
480
+
The [`generic object`](https://docassemble.org/docs/modifiers.html#generic%20object) modifier is a special way to make one question work for many different objects, like people or lists of people.
490
481
:::
491
482
492
483
When you customize a question from the question library,
@@ -498,10 +489,7 @@ To make it specific:
498
489
1. Replace `x` with your variable name.
499
490
1. Customize the `question` and `subquestion` as needed.
500
491
501
-
For example, suppose your interview asks for a list of
502
-
`guardians`. There is no special question about `guardians`
503
-
in the question library, so your interview will use the `generic object`
504
-
version of the question, which looks like this:
492
+
For example, suppose your interview asks for a list of `guardians`. There is no special question about `guardians` in the question library, so your interview will use the `generic object` version of the question, which looks like this:
505
493
506
494
```yaml
507
495
---
@@ -545,13 +533,19 @@ fields:
545
533
A **specific** version of a question is always used
546
534
before the **generic object** version.
547
535
548
-
:::note About the variable `i`
549
-
Just like `generic object` works for any object,
550
-
the variable `i` (and other [`index variables`](https://docassemble.org/docs/fields.html#index%20variables)) lets you write a question for any item
551
-
in a list. Using a **specific** number (typically, just the first, or 0th item is treated specially) overrides the
552
-
one that uses the letter `i`.
536
+
:::note About the variable `i`
537
+
Just like `generic object` works for any object, the variable `i` (and other [index variables](https://docassemble.org/docs/fields.html#index%20variables)) lets you write a question for any item in a list. Using a **specific** number (typically, just the first, or 0th item is treated specially) overrides the one that uses the letter `i`.
553
538
:::
554
539
540
+
<details>
541
+
<summary>More about `i` and `x`</summary>
542
+
543
+
Learn more about `i` and `x` and how they work in Docassemble code in this Document Assembly Line workshop:
0 commit comments