Skip to content

docs: add configuration, compatibility and contributing docs; slim the README - #20

Merged
jackrayner merged 2 commits into
mainfrom
docs/readme-phase2
Oct 24, 2026
Merged

jackrayner merged 2 commits into
mainfrom
docs/readme-phase2

Conversation

@jackrayner

Copy link
Copy Markdown
Owner

Second part of making the README the fork's own. Stacked on #19.

  • docs/configuration.md: every config key and command-line option, written from Options.cpp and d2dx-defaults.cfg rather than the upstream wiki. I checked the order claim in the code (config file first, command line after) and what dumptextures writes.
  • docs/compatibility.md: per-version table for custom resolutions and motion prediction, derived from BuiltinResMod.cpp and D2DXContext.cpp, with a "tested with this fork" column (only 1.14d, under Wine/Proton), plus Windows/Wine and mod notes.
  • CONTRIBUTING.md: build, test and PR conventions for people; AGENTS.md points to it.
  • README: the compatibility section is a short summary linking to the table; documentation and usage sections link to the new docs. Links are absolute because only the README ships in d2dx.zip.

Worth a second look: the Wine/Proton nocompatmodefix explanation and the 1.14d result come from a report of one play session, not from anything I ran. Docs only, so the Windows job is skipped.

🤖 Generated with Claude Code

@jackrayner
jackrayner added this pull request to stack #21 October 24, 2026 14:35
Base automatically changed from docs/cleanup to main October 24, 2026 15:04
jackrayner and others added 2 commits October 24, 2026 16:04
…e README

docs/configuration.md lists every cfg key and command-line option, written from
Options.cpp and d2dx-defaults.cfg. docs/compatibility.md has the per-version
table derived from BuiltinResMod.cpp and D2DXContext.cpp, with what has actually
been tested. CONTRIBUTING.md covers building, testing and the PR conventions for
people. The README now links to them.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Replace the personal thanks with plain credits, merge SGD2FreeRes into the
third-party list, and rename the 'It's ugly/slow/buggy' heading. Every
third-party attribution is kept.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@jackrayner
jackrayner merged commit beaf268 into main Oct 24, 2026
2 checks passed
@jackrayner
jackrayner deleted the docs/readme-phase2 branch October 24, 2026 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant