ReportLog
Documentation menu

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.

KindWhat it asksAsks the reporter for an addressCan be a board filterCan trigger a follow-up
Short text
short_text
One line. A name, a reference, a job title.YesYesNo
Long text
long_text
Several paragraphs. An account, a description, context.YesNoNo
Date
date
A calendar day. Add two if a thing has a start and an end.NoYesNo
Time of day
time
A clock time, with no date attached.NoNoNo
Date and time
datetime
A moment. Stored with its offset, so it survives being read elsewhere.NoYesNo
Place
place
Somewhere. Free text, or a list the operator supplies.Yes, unless the answers are a closed listYesNo
Location on a map
location
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.NoYesNo
Choose one
choice_one
A list where exactly one answer applies.NoYesYes
Choose any
choice_many
A list where more than one answer can apply.NoYesYes
Yes or no
yes_no
A plain either-or.NoYesYes
Evidence they have but are not uploading
evidence_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.YesYesYes
Number
number
A count or a measurement.NoYesNo
Email address
email
A second address, beside the one the spine already collects.YesNoNo
Web address
url
A link. Sealed as typed, so a page that later disappears still has a record of what was pointed at.YesNoNo
Photos, video or documents
file
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.YesNoNo
A note in their own words
private_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.YesNoNo
Links to a post, photo or video
private_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.YesNoNo

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#

See this page's source