Skip to content

Correct the README project-structure tree - #89

Open
tschm wants to merge 1 commit into
alihaskar:masterfrom
tschm:fix/85-readme-structure
Open

Correct the README project-structure tree#89
tschm wants to merge 1 commit into
alihaskar:masterfrom
tschm:fix/85-readme-structure

Conversation

@tschm

@tschm tschm commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Closes #85

Problem

The "Project structure" tree described a layout the repo does not have:

  • It showed src/core/, src/data/, src/api/, src/web/, but the packages live under src/pycharting/. The section's own opening line ("The library follows a modern src/ layout") was right; the tree contradicted it.
  • It listed a top-level data/ # Sample CSVs and fixtures directory that does not exist.
  • It omitted docs/, which does exist and holds how-it-works.md — linked from the paragraph immediately above.

The fence also carried no language tag, so no tooling could check it:

"1 fence(s) carry no language, so nothing can check them: line 250"

Change

The tree now reflects the real layout, drops the non-existent data/, adds docs/, and is tagged ```text.

Verification

  • check_doc_examples.py --source-root src — no untagged fences remain
  • make fmt — markdownlint clean

🤖 Generated with Claude Code

The tree showed src/core/, src/data/, src/api/ and src/web/, but the
packages live under src/pycharting/. It also listed a top-level data/
directory for "sample CSVs and fixtures" that does not exist, and omitted
docs/, which does.

The fence carried no language tag, so nothing could check it. Tagging it
text clears the last untagged fence reported by check_doc_examples.py.

Closes alihaskar#85

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 17, 2026 08:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the README’s “Project structure” section so it accurately reflects the repository’s actual src/ layout and documentation directories, aligning the diagram with the surrounding text and documentation tooling expectations.

Changes:

  • Corrected the tree to show packages under src/pycharting/ rather than directly under src/.
  • Removed the non-existent top-level data/ entry and added the existing docs/ directory.
  • Added a language tag (text) to the fenced tree block so doc tooling can validate it.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

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.

Correct the README project-structure tree

2 participants