Skip to content

refactor: Migrate Handbook to Sphinx Static Site Generator #404

@kgpayne

Description

@kgpayne

Given the companies first language is python 🐍 and the use of Sphinx for other site in the Meltano estate (e.g. the SDK) it would be straight forward to migrate the existing handbook content and layout to Sphinx. The benefits of a switch include:

  • One less static site framework to learn (reduced learning curve for maintainers)
  • Direct reusability of assets across sites (consistency in look and feel)
  • Close parity of experience for content contributors (still just markdown in a directory tree)

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