{
  "title": "Developer documentation feedback survey",
  "questions": [
    "What were you trying to build?",
    "Which example or instruction did you need but could not find?",
    "Could you complete the task after following the documentation?",
    "Which assumption about your environment was unclear?",
    "What would make the example easier to adapt?"
  ],
  "question_notes": [
    "Anchor the response to the task being built rather than a general opinion of the documentation.",
    "Identify a missing example or step so a revision can address the reader's actual obstacle.",
    "Distinguish following the instructions from reaching a useful result in the reader's environment.",
    "Locate an unstated environment assumption without collecting private configuration values.",
    "Find the change that would make adaptation possible; an example that runs unchanged may still fail the user's real task."
  ],
  "answer_guidance": [
    {
      "question": 1,
      "format": "Short open text",
      "reason": "Anchor the response to the task being built rather than a general opinion of the documentation.",
      "optional": true
    },
    {
      "question": 2,
      "format": "Short open text",
      "reason": "Identify a missing example or step so a revision can address the reader's actual obstacle.",
      "optional": true
    },
    {
      "question": 3,
      "format": "Short open text",
      "reason": "Distinguish following the instructions from reaching a useful result in the reader's environment.",
      "optional": true
    },
    {
      "question": 4,
      "format": "Short open text",
      "reason": "Locate an unstated environment assumption without collecting private configuration values.",
      "optional": true
    },
    {
      "question": 5,
      "format": "Short open text",
      "reason": "Find the change that would make adaptation possible; an example that runs unchanged may still fail the user's real task.",
      "optional": true
    }
  ],
  "respondent_instruction": "If nothing was unclear or difficult, say so. Skip questions about steps you did not experience; use not applicable where appropriate.",
  "note": "Examples to adapt. Not a validated instrument."
}