ProficientNowTechRFCs
RFC Standards/RFC Kinds/Bcp/RFC RFCSTD 0004

3. Structure Definition

RFC-RFCSTD-0004                                                   Section 3
Category: Standards Track                            Structure Definition

3. Structure Definition

← Requirements | Index | Next →


3.1 Required Sections for BCP Kind

BCP RFCs MAY be single-file or multi-file depending on complexity:

SectionFileRequirementPurpose
Index00-index.md or inlineREQUIREDMetadata, abstract, applicability
Scope01-scope.md or inlineREQUIREDWhen this BCP applies
Background02-background.md or inlineRECOMMENDEDContext and motivation
Guidelines03-guidelines.md or inlineREQUIREDRecommended practices
Procedures04-procedures.md or inlineCONDITIONALOperational procedures (if applicable)
Considerations05-considerations.md or inlineRECOMMENDEDTrade-offs and alternatives
Glossaryappendix-a-glossary.mdREQUIREDTerms
Referencesappendix-b-references.mdREQUIREDRelated RFCs, external docs

3.2 Section Requirement Levels

LevelMeaningOmission Criteria
REQUIREDSection MUST be presentCannot be omitted
RECOMMENDEDSection SHOULD be presentMay omit with justification in Index
CONDITIONALSection MUST be present if criteria metMay omit if criteria don't apply

3.2.1 Procedures Section Criteria (CONDITIONAL)

The Procedures section is REQUIRED when:

CriterionExample
BCP includes step-by-step operational tasksSecret rotation procedure
BCP describes how to perform specific actionsIncident response steps

The Procedures section MAY be omitted when:

CriterionExample
BCP is purely guidelines-basedCode review guidelines
No specific operational tasks are describedSecurity principles

3.3 Section Content Requirements

3.3.1 Index Section

The index MUST include:

ComponentRequirementDescription
Metadata TableREQUIREDAll fields including Kind: BCP
AbstractREQUIREDBrief summary of practices covered
Applicability StatementREQUIREDWho should follow this BCP
Table of ContentsREQUIREDLinks to all sections

3.3.2 Scope Section

The scope section MUST define:

ComponentRequirementDescription
In ScopeREQUIREDWhat practices this BCP covers
Out of ScopeREQUIREDWhat is explicitly excluded
AudienceREQUIREDWho should follow these practices
PrerequisitesRECOMMENDEDKnowledge or access required

3.3.3 Background Section

The background section SHOULD include:

ComponentRequirementDescription
ContextRECOMMENDEDWhy these practices exist
HistoryOPTIONALHow practices evolved
MotivationRECOMMENDEDProblems these practices solve

3.3.4 Guidelines Section

Each guideline MUST follow this structure:

ComponentRequirementDescription
RecommendationREQUIREDStatement using SHOULD/RECOMMENDED
RationaleREQUIREDWhy this is recommended
ApplicabilityREQUIREDWhen to apply
ExceptionsREQUIREDWhen this may not apply

3.3.5 Procedures Section (Conditional)

If included, each procedure MUST follow this structure:

ComponentRequirementDescription
When to UseREQUIREDTrigger conditions
PrerequisitesREQUIREDWhat must be true before starting
StepsREQUIREDSequential actions
VerificationREQUIREDHow to confirm success
RecoveryREQUIREDWhat to do if procedure fails

3.3.6 Considerations Section

The considerations section SHOULD include:

ComponentRequirementDescription
Trade-offsRECOMMENDEDCosts and benefits of recommendations
AlternativesRECOMMENDEDOther valid approaches
Context DependenciesRECOMMENDEDHow context affects applicability
Evolution NotesOPTIONALHow these practices may change

3.3.7 Glossary

The glossary MUST include:

ComponentRequirementDescription
Term DefinitionsREQUIREDAll BCP-specific terms
Consistent FormatREQUIREDEach term follows same format

3.3.8 References

The references section MUST include:

ComponentRequirementDescription
Related RFCsREQUIREDArchitecture, Specification RFCs
External ReferencesRECOMMENDEDIndustry standards, documentation
Version HistoryREQUIREDChange log for this BCP

3.4 File Naming Convention

For multi-file BCPs:

PatternUsage
00-index.mdIndex
01-scope.mdScope
02-background.mdBackground
03-guidelines.mdGuidelines
04-procedures.mdProcedures (if applicable)
05-considerations.mdConsiderations
appendix-<letter>-<name>.mdAppendices

For single-file BCPs:

PatternUsage
RFC-BCP-<DOMAIN>-NNNN.mdComplete BCP in one file

End of Section 3 — RFC-RFCSTD-0004