Opened 13 years ago

Closed 12 years ago

#18 closed defect (fixed)

make better sphinx templates

Reported by: Will Kahn-Greene Owned by:
Priority: trivial Milestone:
Component: programming Keywords:
Cc: Parent Tickets:

Description (last modified by Will Kahn-Greene) 

We use Sphinx to build the documentation. We need a better set of
templates so:


1. our docs look like our docs
2. our docs don't look like everyone else's docs
3. we can tweak the look-and-feel to make our docs more readable
   and usable

We should at least do a first pass of this for 0.0.1.

The templates are Jinja2 templates. It's possible we might be fine
with just adjusting the CSS.

Change History (6)

comment:1 by Will Kahn-Greene, 13 years ago

Milestone: 0.0.1 → 0.0.2 
Pushing this off to 0.0.2.

comment:2 by Christopher Allan Webber, 13 years ago

Milestone: → 0.0.2 
Removing the target version on this, I don't think it's high
priority... the docs look good enough for now.

comment:3 by Will Kahn-Greene, 13 years ago 

If it's not a high priority, then I vote we reject this bug.

Also, maybe it's a better idea to ditch docs.mediagoblin.org and
instead use ReadTheDocs ?

comment:4 by Christopher Allan Webber, 13 years ago

Priority: Normal → Low 
I don't know much about readthedocs. I'm okay with closing this for
now.. if someone wants to pick up prettyifying the sphinx docs, I'm
happy to see it happen and this reopened, but I suspect nobody has
the time to do it?

I'm marking it as low for now at least.

comment:5 by Will Kahn-Greene, 12 years ago

The original url for this bug was ​http://bugs.foocorp.net/issues/279 .

comment:6 by Will Kahn-Greene, 12 years ago

Component: → programming
Description: modified (diff)
Resolution: → fixed
Status: accepted → closed

I think schendje did this already, so I'm marking as FIXED.

Note: See TracTickets for help on using tickets.