The package name quantecon-sphinx-theme was flagged as unsatisfying during the theme evaluation in QuantEcon/lecture-python-programming#475 (closed, never merged), with quantecon-minimal-sphinx-theme offered as one alternative and the list left open.
Why it's a real decision, not bikeshedding. The name has to match the theme's purpose, and the record currently holds two different purposes:
| Source |
Stated purpose |
PLAN.md in this repo |
A brand-neutral, general-purpose theme extracting reusable parts of quantecon-book-theme, explicitly "the upstream base that quantecon-book-theme can later inherit from" |
| Comments on QuantEcon/lecture-python-programming#475 |
A second QuantEcon theme for non-core lecture series — topic series, contributor series — protecting QE identity by keeping quantecon-book-theme restricted |
These pull the name in opposite directions. If it is the brand-neutral upstream base, a quantecon- prefix is actively misleading to outside adopters and something unprefixed would serve better. If it is the second QuantEcon theme, the prefix is right and the question is only what qualifier follows it — minimal, docs, lite.
Settle the positioning first, then the name follows. This is worth resolving before any release, since the name becomes load-bearing on PyPI, in html_theme, and in the module path src/quantecon_sphinx_theme/ the moment anything depends on it. Nothing depends on it today — no tags, no releases, no downstream users — so renaming is currently free.
The package name
quantecon-sphinx-themewas flagged as unsatisfying during the theme evaluation in QuantEcon/lecture-python-programming#475 (closed, never merged), withquantecon-minimal-sphinx-themeoffered as one alternative and the list left open.Why it's a real decision, not bikeshedding. The name has to match the theme's purpose, and the record currently holds two different purposes:
PLAN.mdin this repoquantecon-book-theme, explicitly "the upstream base thatquantecon-book-themecan later inherit from"quantecon-book-themerestrictedThese pull the name in opposite directions. If it is the brand-neutral upstream base, a
quantecon-prefix is actively misleading to outside adopters and something unprefixed would serve better. If it is the second QuantEcon theme, the prefix is right and the question is only what qualifier follows it —minimal,docs,lite.Settle the positioning first, then the name follows. This is worth resolving before any release, since the name becomes load-bearing on PyPI, in
html_theme, and in the module pathsrc/quantecon_sphinx_theme/the moment anything depends on it. Nothing depends on it today — no tags, no releases, no downstream users — so renaming is currently free.