Question kinds
Every kind of question a logbook or list can ask, read from the code, with which ones make the form ask for an email address.
Logbooks and lists are built from the same kinds of question. This table is read from packages/fields, so it always matches what the builder offers.
| Kind | What it asks | Asks the reporter for an address | Can be a board filter | Can trigger a follow-up |
|---|---|---|---|---|
Short textshort_text | One line. A name, a reference, a job title. | Yes | Yes | No |
Long textlong_text | Several paragraphs. An account, a description, context. | Yes | No | No |
Datedate | A calendar day. Add two if a thing has a start and an end. | No | Yes | No |
Time of daytime | A clock time, with no date attached. | No | No | No |
Date and timedatetime | A moment. Stored with its offset, so it survives being read elsewhere. | No | Yes | No |
Placeplace | Somewhere. Free text, or a list the operator supplies. | Yes, unless the answers are a closed list | Yes | No |
Location on a maplocation | A country, or a US state or territory, chosen from a list; a US question can ask for the county too. This is the question a heat map counts — pick this one rather than Place if the answers need to add up. Only one per logbook can feed a map. | No | Yes | No |
Choose onechoice_one | A list where exactly one answer applies. | No | Yes | Yes |
Choose anychoice_many | A list where more than one answer can apply. | No | Yes | Yes |
Yes or noyes_no | A plain either-or. | No | Yes | Yes |
Evidence they have but are not uploadingevidence_declaration | Asks whether they have photos, video, audio or documents of this, without asking for them. A moderator can ask later, if the reporter also gives permission to be asked. Add a short text question after it, shown only when the answer is yes, for what it is of. | Yes | Yes | Yes |
Numbernumber | A count or a measurement. | No | Yes | No |
Email addressemail | A second address, beside the one the spine already collects. | Yes | No | No |
Web addressurl | A link. Sealed as typed, so a page that later disappears still has a record of what was pointed at. | Yes | No | No |
Photos, video or documentsfile | A place to attach files. Put it where you want to ask for them — a logbook takes files if, and only if, it has one of these. Everything is re-encoded, so camera metadata and location do not survive. | Yes | No | No |
A note in their own wordsprivate_text | Several paragraphs in their own words. Kept apart from the report so it can be erased. Moderators read it, and may share what it says with vetted journalists if the reporter agrees. | Yes | No | No |
Links to a post, photo or videoprivate_link | Up to three links. Kept apart from the report so each can be erased. Moderators check them, and may share them with vetted journalists if the reporter agrees. | Yes | No | No |
Asks the reporter for an address: a form containing any question marked Yes asks every reporter for an email address, and files the report only after it is confirmed. A form whose questions are all marked No files each report the moment it is sent, with no address at all. See Logbooks.
Can be a board filter: the site's administrators choose which of these questions readers may filter the board by. Nothing is a filter by default.
Can trigger a follow-up: a later question can be asked only when this question had a particular answer.
A few details#
- Location on a map answers with a code from a fixed list (
DE,US-AZ, or a US county such asUS-AZ-04013), so the answers can be counted on a heat map. A US question can ask for the county; "not sure which county" stays an answer for the state. - Date, Time of day and Date and time can be limited to a range; the picker offers nothing outside it.
- Photos, video or documents are not sealed themselves: their fingerprints are. So a file can be erased without breaking the chain.
- Evidence they have but are not uploading records that a reporter has something they are not uploading, so a moderator can ask for it later. What they said is sealed; whether they want to be asked is their permission to change.