Skip to content

Documentation theme contest 🏆 #84

Closed
@schneiderfelipe

Description

@schneiderfelipe

Related to #83. From https://sphinx-themes.org/#themes:

  • Alabaster: too boring
  • Read the Docs: too common
  • Furo
  • Book
  • PyData: too informal
  • Press: too corporatey
  • Celery: boring²
  • Insegel: corporatey²
  • Insipid: ...insipid
  • Material: too Androidy/Googley
  • Material: ugly³
  • Basicstrap: boring
  • Bernard: makes me puke
  • Better: ugly, boring, oh boy
  • Bootstrap: makes me cry
  • Cloud: God, no
  • Documatt: too universitey
  • Groundwork: good, but dark and too ruby/rails/jekyll
  • Hachibee: too kawaii
  • Karma (decent)
  • Kotti: too flat
  • Maisie: nice but spacing is bad
  • Murray: too latexy/waxy/scholarly
  • PD: too facebookey
  • PDJ: too serious
  • Python: too... Python!
  • Readable: better Alabaster, but still bad
  • Redactor: simply bad
  • renku: doesn't even compile
  • Sandstone: too Firefoxey
  • Sizzle: too corporatey
  • Solar: please no
  • Stanford (nice, an improved RTDs)
  • Topos: almost cried
  • Yummy: we don't sell cosmetics
  • ZeroVM: too 1999
  • tibas.tt: too animey
  • agogo: NO
  • bizstyle: NO²
  • classic: ugy, 1996!
  • haiku: clean but boring
  • nature: can't stand
  • pyramid: sad gray
  • scrolls: God, woody background! NO
  • sphinxdoc: default is too default
  • traditional: surprisingly works, but boring

Round two

Theme Logo fits? Code stands out? Are boxes good? Is navigation nice? Has next button? Is text readable?
Furo Probably Somewhat Somewhat Yes Yes Yes²
Book Yes Yes Yes Yes Yes Yes
Karma No Somewhat No No No Not really
Stanford Probably not Yes Yes Yes Yes Yes

Veredict

  • Furo* got 2 + 0 + 1 + 1 + 1 + 2 = 7 points
  • Book got 3 + 1 + 2 + 1 + 1 + 1 = 9 points
  • Karma got 0 + 0 + 0 + 0 + 0 + 0 = 0 points
  • Stanford got 1 + 1 + 2 + 1 + 1 + 1 = 7 points

Being a dictator I opted for Stanford because it is cleaner, has more contrast and less clutter.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions