Find best platform for an "overview webpage" for the project

Issue #3 resolved
Johan Rosenkilde created an issue

We have (more or less) agreed that there should be an overview web page giving a nice impression of the roadmap for the project as well as at least a rough idea of the code design and implemented features.

This page needs to be based somewhere and in some format. Off the top of my hat, there are several possibilities:

  • The SageWiki

    Pros:

    • It is part of the official Sage page.
    • It is free, easy and immediately usable.
    • It can be edited by anyone with a Trac account. This could be good to avoid information rotting.

    Cons:

    • It doesn't seem to be very used or read
    • It is ugly and perhaps doesn't easily present a nice overview.
    • It has arbitrary technical limitations (e.g. can we put a full-sized, svg image at the center?)
    • It can be edited by anyone with a Trac account. This can be bad since it is really our decision what should be part of our project roadmap.
  • Our Bitbucket front page

    Pros:

    • It is free and easy (uses Markdown syntax).
    • It has fewer arbitrary technical limitations
    • Anyone with write-rights to the repository can edit it

    Cons:

    • It requires opening up the repo for public read (but we might do that anyway)
    • It requires advertising this repo (but most people that interested in the project might need to know about it anyway)
    • There are still technical limitations (we probably can't make a nicely formatted HTML-formatted table of Trac-tickets related to the project, which is dynamically updated according to their status on [trac.sagemath.org])
  • A web page we host at some INRIA servers, possibly with a nice domain for it

    Pros:

    • Ultimate technical freedom

    Cons:

    • Laborious to set up.
    • It requires advertising this web page, which otherwise noone would visit
    • The added technical freedom also requires work to utilise
    • Probably would allow only INRIA-employees with specific access grants to modify

Comments (1)

  1. Log in to comment