P4-REQ-21-11-003

Return to Requirements

The Developer Handbook SHALL define generated-file header conventions.

Part 4, Section 21.11: Developer Handbook Requirements.

Generated files require metadata that identifies their source definition, generator, generation context, regeneration rule, and manual-editing status.

Defining generated-file header conventions supports reproducibility and allows reviewers to distinguish generated artifacts from hand-authored implementation logic.

This requirement applies to:

• generated types;
• generated DDS support code;
• generated bindings; and
• other generated artifacts included in the Phase 0 baseline.

Verification SHALL confirm that the Developer Handbook defines generated-file header conventions.

Verification activities should include review checks confirming that:

• source-definition identification is required;
• generator identification is required;
• generation context is addressed;
• regeneration rules are addressed; and
• manual-editing rules are addressed.

This requirement establishes the handbook rule governing generated-file identification and regeneration metadata.

Related requirement identifiers:

• P4-REQ-21-11-002
• P4-REQ-21-10-007

Related source section:

• 21.11 Developer Handbook Requirements

Draft