straywild/docs

NETfishing documentation

This directory is the single home for maintained project documentation. Start here instead of searching feature, asset, world, or script directories for local README files.

Authoritative references

• DEVELOPMENT.md: architecture, engineering decisions, content and balance policy, authoring guidance, and validation.
• ATTRIBUTION.md: ownership, credits, licensing map, third-party notices, asset provenance, and redistribution requirements.
• PORTMASTER.md: PortMaster packaging, installation, controller mapping, performance behavior, and hardware release checks.
• README-PLAYTEST.txt: the player-facing README staged into desktop playtest packages.

Related repositories

• Discovery service API stays with the service implementation and defines its versioned HTTP contract.
• Dedicated-server packaging stays with its installer and update scripts. It consumes this repository's attribution and legal notices from the exact pinned game commit instead of maintaining copies.

Those code-coupled references remain in their own repositories. Game-wide architecture, authoring, licensing, credits, and provenance are not duplicated there.

Exact runtime values and behavior remain authoritative in source code, scenes, and resources. These documents describe boundaries, policy, and maintenance procedures; they should not duplicate changing constants or inventories that can be derived reliably from the project.

The same rule applies to credits. ATTRIBUTION.md records creators, licenses, and durable contribution families. It does not attempt to mirror every current asset filename or private intake-directory layout. Planned or unincorporated work is not described as shipped, and repository paths are included only when they help recipients locate a distributed third-party work or license.

Files intentionally kept at the repository root

The following are entry points or governing legal documents rather than general project documentation, so they remain at conventional root paths:

• README.md
• CONTRIBUTING.md
• LICENSE
• ASSET-LICENSE.md
• TRADEMARKS.md
• CONTRIBUTOR-TERMS.md

CONTRIBUTING.md records that unsolicited contributions are not accepted. CONTRIBUTOR-TERMS.md remains a governing legal record for previously accepted and expressly invited work, not an invitation for new submissions.

Third-party font license texts stay beside their font files under ui/fonts/ so the licensed files and their original notices cannot drift apart. Build scripts collect those legal files and the authoritative attribution record when assembling releases.

Maintenance rule

Do not add feature-specific README files elsewhere in the repository. Add or update the appropriate reference above and link to its heading when source comments need more context. Player-facing package instructions belong only in README-PLAYTEST.txt; source and scripts remain authoritative for command-line usage.

Before adding a literal project path to prose, verify that it exists in the same revision and that readers actually need the path. Prefer a stable owner, interface, or resource type over a directory listing. A path or Git author is never evidence of creative authorship.