Skip to content

docs: add memory debugging guide - #1045

Closed
cosven wants to merge 1 commit into
feeluown:masterfrom
cosven:codex/memory-debugging-docs
Closed

docs: add memory debugging guide#1045
cosven wants to merge 1 commit into
feeluown:masterfrom
cosven:codex/memory-debugging-docs

Conversation

@cosven

@cosven cosven commented May 27, 2026

Copy link
Copy Markdown
Member

Summary

  • Add a developer guide for memory debugging with Memray and native/system tools.
  • Document the minimal Qt baseline step before attributing resident memory to FeelUOwn.
  • Record macOS vmmap interpretation notes for Physical footprint, Writable resident, TOTAL resident, and USS-style estimates.

Test Plan

  • git diff --check -- docs/source/index.rst docs/source/memory_debugging.rst
  • uv run sphinx-build -b html docs/source docs/_build/html

Notes: Sphinx build succeeds with existing warnings, including missing PyQt6 in this isolated worktree virtualenv for GUI autodoc imports and existing docstring/reference warnings.

@cosven cosven closed this Jul 1, 2026
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