Super Practica Design Specifications

Introduction

This repository contains the most current design specifications for Super Practica. A "design-spec" is a snapshot of design goals and documentation for a programmer to use to develop the game, which can be called "implementing the specification". It also helps to document the intended mechanics of the game to prevent regressions.

Because Super Practica's design is based on reasoning within an empirical framework, it has greater need of design-specs than most games. They can make more clear how designs follow from theory and principles, and what designs empirical tests actually test.

Review and Obsoletion

It can be a good idea to move quickly in iterating game design without updating the design-specs each time. Design-specs will therefore often go out of sync from the design of the game. As a result, different design goals might be documented between the game's code and the design-specs. The design-specs here will be periodically reviewed to better match current design decisions, but they can remain in an out-of-sync state for a while. In the case of ambiguity of design goals between these, the solution is to ask designers to resolve the ambiguity.

Design-specs that no longer represent current design goals will be moved to the design archive. Only current and active design-specs will be kept in this repository.