Skip to content

Conversation

@dimitri-yatsenko
Copy link
Member

Summary

Adds documentation for programmatic configuration access, specifically explaining:

  1. Dot notation for reading/writing settings directly
  2. Double underscore syntax for nested settings in override() context manager

Context

This addresses user confusion about why the summary table shows dj.config.display.diagram_direction but code examples use display__diagram_direction in override().

Both are correct:

  • dj.config.display.diagram_direction — direct attribute access
  • display__diagram_direction — kwargs in override() (Python doesn't allow dots in kwarg names)

Changes

Added new "Programmatic Access" section to reference/configuration.md:

  • Reading and Writing Settings
  • Temporary Overrides with override()
  • Nested settings syntax explanation

🤖 Generated with Claude Code

- Add "Programmatic Access" section to configuration reference
- Document dot notation for reading/writing settings
- Explain double underscore syntax for nested settings in override()
- Clarify that display__diagram_direction maps to display.diagram_direction

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@MilagrosMarin MilagrosMarin merged commit 249f133 into main Jan 27, 2026
1 check passed
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.

3 participants