This repository contains the public question bank, survey flow, validation schemas, preview tooling, and historical archive for the Stack Overflow Annual Developer Survey. The goal is to make the survey instrument easier to inspect, discuss, improve, and maintain over time.

You can view the current live survey preview at stackoverflow-survey-preview.netlify.app. It reflects the latest deployed copy of the survey preview from this repository.

You do not need to know GitHub, YAML, npm, or code to help shape the survey.

If you want to suggest a question, answer option, wording change, or insight for the 2026 survey, start a post in GitHub Discussions. You can write it in plain English. Comments, refinements, and upvotes on other suggestions are also helpful because they show where there is community interest or concern.

Stack Overflow reviews suggestions and community feedback, but inclusion in the final survey is at Stack Overflow's discretion. Some good ideas may not fit the survey's scope, timing, methodology, legal/privacy requirements, or need for year-over-year comparability.

Title: Ask whether developers are using AI agents in production workflows

Suggestion:
Add a question about whether respondents use AI agents for production work,
experimentation, learning, or not at all.

Why this matters:
The current AI conversation often mixes casual use with production use. This
would help readers understand how widely agentic tools are actually embedded
in day-to-day professional work.

Possible answers:
- Yes, for production work
- Yes, for experiments or prototypes
- Yes, for learning or personal projects
- No, but I plan to
- No, and I do not plan to

• questions/ — YAML source files for survey questions, plus the top-level questions/survey.yaml flow definition.
• packages/survey/ — Svelte/Vite tooling for previewing the survey, validating YAML, and preparing the survey for Qualtrics.
• packages/archive/ — Historical survey releases, including results data, schemas, PDFs, and static result pages.

We welcome community recommendations for questions, answer choices, wording changes, and insights the survey should be able to produce this year.

For survey content ideas, please start with GitHub Discussions rather than opening a pull request right away. A good Discussion gives the community and maintainers room to refine the idea before anyone turns it into YAML.

Useful suggestions usually include:

• The question, answer option, or insight you want the survey to capture.
• Why it matters and who would use the result.
• Whether it is new, replaces an existing question, or changes wording/options.
• Any prior art, such as related research, other surveys, or past Stack Overflow survey results.
• For changes to recurring questions, how the change affects year-over-year comparability.

Comments and upvotes on suggestions are encouraged. They help signal interest, identify unclear wording, and surface tradeoffs. They are not votes that automatically determine the final survey; Stack Overflow is responsible for the final instrument.

Use issues for bugs and PRs for focused implementation or documentation changes. See CONTRIBUTING.md for more detail.

Questions live as individual YAML files under questions/{section}/{QuestionId}.yaml. Each file's question.id is the stable handle used for response data and cross-question references.

The survey order and branching live in questions/survey.yaml. The flow file defines blocks, pages, randomization, and if/then logic. Conditional visibility is centralized there rather than stored on individual question files.

See questions/README.md for the YAML format, option keys, validation descriptors, question type mapping, and survey flow syntax.

This project is an npm workspace. Install dependencies from the repo root:

npm install

Run the live survey preview:

npm run dev -w survey

Validate the question files and survey flow:

npm run validate -w survey

Check formatting:

npm run lint

Apply formatting:

npm run format

The survey package also includes:

npm run check -w survey
npm run build -w survey
npm run gen:types -w survey

Survey releases follow a yearly-with-patches scheme:

• v2026 — initial release of the 2026 survey.
• v2026.1, v2026.2, ... — corrections, metadata fixes, and late clarifications for the 2026 release.

Branches:

• main — current development for the next upcoming survey year.
• release/YYYY — long-lived branch for patching a historical survey year.

When a survey year locks, main is branched to release/YYYY and tagged vYYYY. Later patches for that year land on its release branch and are tagged as .N revisions. main continues toward the next survey year.

Each question carries a version: 'YYYY.N' field matching the release it ships under. Once a question ID appears in a tagged release, the ID is frozen; substantially different questions should receive a new ID so historical response columns remain interpretable.

The survey is fielded primarily through Stack Overflow's own channels, which means the respondent pool is self-selecting and weighted toward already-engaged users. Opening the instrument helps the community review and improve it before fielding.

This is especially useful for:

• Flagging ambiguous or leading wording.
• Identifying missing answer choices.
• Surfacing geographic, cultural, or professional blind spots.
• Preserving longitudinal comparability when questions change.
• Making methodology and survey structure easier to audit.

Data is published under the Open Database License (ODbL) 1.0; individual cell contents are published under the Database Contents License (DbCL) 1.0.

In summary, you are free to share, create, and adapt the database as long as you attribute it, preserve the license notice, share adapted databases under the ODbL, and keep redistributed database versions open.

© Copyright 2026 Stack Exchange, Inc.

Unless otherwise stated, the contents of this repository are licensed under the Apache License, Version 2.0.

Unless required by applicable law or agreed to in writing, software distributed under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

The Stack Overflow name and logo, and associated brand elements, are the protected property of Stack Exchange, Inc. Acceptable use of Stack Overflow trademarks is governed by the Stack Overflow trademark guidance. All other use of Stack Overflow trademarks is prohibited without prior written authorization, including without limitation any use suggesting unauthorized endorsement by or affiliation with Stack Overflow.