October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

ADR vs. RFC vs. Design Document: When to Use Each

A design document explains a proposal, an internal RFC organizes review, and an ADR records a consequential decision. Here’s how to choose and link them.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use a design document to explain a proposed implementation and collect feedback, an internal RFC to invite a defined group to comment before a decision, and an ADR to preserve the context, choice, and consequences of a significant architectural decision. A common workflow is to develop the proposal in a design document or internal RFC, then record the final decision in a concise ADR and link the documents.

One important caveat: “RFC” can also mean a formally published document in the Internet RFC Series. That is not simply an internal proposal awaiting comments, and an RFC is not automatically an Internet Standard.

As an Amazon Associate I earn from qualifying purchases.

What is the difference between an ADR, RFC, and design document?

Document Main purpose Typical timing What it should make clear
Design document Explain a proposed implementation well enough for people to review and improve it While the design is still open to change Problem, goals, proposed approach, alternatives, risks, open questions, and feedback needed
Internal RFC Invite comments on a proposal from a defined group before a choice is settled Before the decision Scope, options, trade-offs, affected teams, review process, decision owner, and how feedback will be resolved
ADR Record why a significant architectural choice was made and what follows from it When a decision is made; updated through a new record if it changes Context, selected option, consequences and trade-offs, status, date, and links to supporting material
IETF Internet-Draft or RFC Develop or publish Internet technical specifications through the relevant standards process Through IETF collaboration, review, and publication processes The document’s stream and status, and its relationship to other RFCs or standards work

The first three are not competing templates so much as artifacts for different jobs: explain, solicit feedback, and preserve a decision. Google’s documentation best practices describe design documents as proposals used to collect feedback; after implementation, they can serve as archives of decisions rather than authoritative, continuously current implementation instructions. AWS and Google Cloud similarly describe ADRs as records of significant decisions and their rationale.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When should you write an ADR?

Write an ADR when a consequential architectural choice is worth understanding later—especially when it affects system structure, quality attributes, or behavior, and a future team might otherwise repeat the debate or miss a trade-off. Google Cloud’s ADR overview frames the use case around choosing between two or more engineering options and recording the reasons for the selection.

An ADR is a decision record, not a repository for every implementation detail. Include the material context, the chosen option, and its consequences. Add status and date, and link to the proposal, review, or implementation where useful. AWS Prescriptive Guidance summarizes the core as: “Each ADR describes the architectural decision, its context, and its consequences.” See its ADR process for lifecycle guidance.

If the decision changes

Keep the old ADR as a record of what was decided at the time, and create a new ADR that supersedes it. Explain which constraints or evidence changed. AWS describes accepted ADRs as immutable, with a later accepted ADR superseding an earlier one; the GOV.UK Architectural Decision Record Framework is another published framework for structuring these records.

Should you write an RFC or a design document?

Choose a design document to explain the proposed implementation

Use a design document when reviewers need enough detail to assess how a solution might work: its goals, approach, alternatives, risks, impact, and unresolved questions. Google’s guidance says, “A good design doc or PRD discusses the proposed implementation at length for the purpose of collecting feedback on that design.” The useful length and format depend on the problem; the document should give reviewers the information they need, not satisfy an arbitrary page count.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

After implementation, mark what was decided and what changed during review. The design document may remain a useful archive, but it should not look like current implementation instructions if the system has moved on.

Choose an internal RFC when your team has a review process for proposals

An internal RFC is useful when a proposal needs comments from a defined audience before a decision. Include the review scope, affected teams, options and trade-offs, who owns the decision, how long feedback is open if your process sets a window, and how the final disposition will be recorded.

There is no universal company-wide RFC workflow. Teams use the term differently, so make the local meaning explicit: who comments, who decides, and whether the RFC itself is updated after the decision or linked to a separate ADR. An internal RFC is not a substitute for a decision record unless it clearly preserves the final choice and rationale.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Do you need both an RFC or design document and an ADR?

Often, yes—when a proposal needs substantial review and its eventual architectural choice will matter to future maintainers. Keep the proposal focused on exploring the options and collecting feedback; use the ADR to state what was actually chosen and why. Link the documents rather than copying the whole discussion into each one.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If the proposal changes during review, update its disposition and make the final record unambiguous. An ADR can link back to the proposal and discussion; the proposal can point forward to the accepted decision. For a small or routine choice that has little lasting architectural consequence, a separate ADR may add more process than value.

Is every RFC an Internet Standard?

No. In Internet standards work, an RFC is a published document in the RFC Series. The series includes multiple streams and statuses, and RFC publication alone does not make a document an Internet Standard. An Internet-Draft is a working document, not an RFC, and its publication does not mean that it has been approved or will eventually become an RFC.

The RFC Editor explains the series, streams, and statuses in What Is an RFC? Its How RFCs Are Created guide describes the Internet-Draft and publication process. When evaluating a particular RFC, check its current metadata, stream, status, and any related updates or obsoletions rather than inferring its standards standing from the RFC number.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.