2 Development

Frank Harris edited this page 2026-06-20 13:04:55 -05:00

Table of Contents

• Development
• Development Workflow
• Validation Expectations
• Good Practices
• TODO

Development

This wiki follows a source-first workflow.

Development Workflow

1. Read the relevant wiki page.
2. Inspect the current GSP source file.
3. Compare with earlier inherited behavior only when that history helps explain the current design.
4. Implement the change in the GSP codebase.
5. Validate syntax and schemas.
6. Update documentation when behavior changes.

Validation Expectations

• run PHP lint on modified PHP files
• run the XML validation script when game configs change
• keep generated or imported documentation aligned with current source evidence

Good Practices

• preserve existing conventions unless there is a clear reason to change them
• use Needs Verification markers when source evidence is incomplete
• keep Workshop work in the dedicated steam_workshop module

TODO

• add repo-specific branching and review rules if the project adopts a formal release workflow