[DRAFT] TRIAGE.md: library-vs-examples classification (planning doc)#2757
Draft
keon wants to merge 1 commit into
Draft
[DRAFT] TRIAGE.md: library-vs-examples classification (planning doc)#2757keon wants to merge 1 commit into
keon wants to merge 1 commit into
Conversation
Draft classification of every source file in algorithms/ into either LIBRARY (reusable, canonical) or EXAMPLE (LeetCode/puzzle-style problem solution), in preparation for the planned split between algorithms/ (continues to ship on PyPI) and a new top-level examples/ tree. Status: draft — needs maintainer review. ~182 library, ~164 example, ~9 explicitly flagged ambiguous. Surfaces several cross-cutting issues (duplicate filenames across categories, misfiled algorithms) that should be resolved as part of the migration. No code changes; just the planning doc. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Draft classification doc for the planned split between library (reusable algorithms/data structures that ship on PyPI) and examples (LeetCode/puzzle-style problem solutions).
This PR contains only the planning doc — no code moves yet. Once you review and override the borderline calls, I'll execute the file moves in batches (one PR per top-level category).
Settled decisions captured in the doc:
Numbers
Review focus
The 9 ❓ AMBIGUOUS rows are the highest-value items to decide. Beyond those, please skim each category table and flag any disagreements — even a single line like "flip `X.py` to library" is enough; I'll integrate edits and produce a v2 before any code moves.
Four open questions are listed at the end of TRIAGE.md (default for ambiguous calls, linked-list philosophy, sub-categories under examples/, test layout).
🤖 Generated with Claude Code