ProficientNowTechRFCs

10. Review and Maintenance

RFC Authoring Standards                                          Section 10
Category: Standards Track                        Review and Maintenance

10. Review and Maintenance

← Glossary | Index | Next →


10.1 Review Checklist

Before submitting for review, verify:

Structure

  • RFC identifier is unique and properly formatted
  • All required sections are present for the RFC kind
  • Navigation links are correct
  • Multi-file structure follows naming conventions

Content

  • No implementation code or timelines included
  • All invariants are numbered and use RFC 2119 keywords
  • All assumptions are explicitly stated
  • Rationale section documents all considered alternatives
  • Content is original (not copied from other RFCs)

Glossary and References

  • Glossary defines all domain-specific terms
  • All diagrams are indexed
  • References are properly formatted
  • Version history is included

10.2 Reviewer Responsibilities

Reviewers SHOULD verify:

AspectWhat to Check
Technical accuracyAre statements correct?
CompletenessAre all required sections present?
InvariantsAre invariants falsifiable and well-reasoned?
RationaleAre alternatives adequately documented?
ClarityIs the RFC clear and unambiguous?
StandardsDoes it adhere to these standards?

10.3 RFC Updates

When updating an RFC:

StepAction
1Increment the version number appropriately
2Update the "Last Updated" date
3Document changes in version history
4Maintain backward compatibility where possible

10.4 RFC Supersession

When an RFC is superseded:

StepAction
1Change status to "Superseded"
2Add "Superseded By" field to metadata
3Reference the superseding RFC
4Do not delete the original
5Freeze content (no further changes)

10.5 Deprecation Notice

When deprecating portions of an RFC:

> **DEPRECATED**: This section is deprecated as of v2.0.0.
> See [RFC-NEW-0001](./path) for the replacement approach.

End of Section 10 — RFC Authoring Standards

On this page