Skip to content

Which projects will continue using Sphinx or migrate to another SSG? #1305

Description

@hwhsu1231

Hello @executablebooks maintainers,

I have submitted a Jupyter Foundation Funding Proposal (jupyter-governance/funding-proposals#38), which is currently under review. The proposal aims to establish continuous, automated documentation localization infrastructure for key projects across the Jupyter ecosystem under the @localizethedocs initiative. As part of the proposal, I have listed the following candidate projects, all of which are currently based on Sphinx:

However, I’ve observed that several projects within the Jupyter ecosystem are gradually migrating from Sphinx (Jupyter Book v1) to MySTMD (Jupyter Book v2). Since MySTMD does not yet implement full gettext-based i18n support (jupyter-book/mystmd#2980), migrating a project away from Sphinx midway may pause localization maintenance after the l10n projects are published.

Therefore, I would like to confirm: which of these candidate projects will continue using Sphinx, and which have already decided to migrate to another SSG (static site generator)? This will help ensure that the proposal and any future localization work reflect the projects’ plans.

Activity

  1. bsipocz commented on Sep 23, 2026

    @bsipocz
    Member

    Some of these are in "maintenance" mode, we keep doing releases but in reality we moved onto JBv2 already.

  2. hwhsu1231 commented on Sep 23, 2026

    @hwhsu1231
    Author

    @bsipocz Can we confirm that these @executablebooks projects will continue to use Sphinx?

  3. bsipocz commented on Sep 23, 2026

    @bsipocz
    Member

    The ones I maintainence mode maintain, yes, they do stay on sphinx, but at some point we may just flip the switch and archive the repos.
    And we won't do any new feature development, etc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions