Jonny Lamb
2007-06-03 14:58:02 UTC
Greetings,
I am currently trying to upgrade the website. What I want to achieve is
move completely from the old website[0] on SourceForge to the synce.org
website[1]. However, the latter also needs an upgrade as the wiki is
getting heavily laden, becoming harder to navigate, and getting
out-of-date.
The idea is not to have documentation on the website but in docbook for
the following reasons:
* Docs can be read off-line.
* Docs are easier to be printed.
* Docs are in many different formats -- HTML (chunk/all), PDF, TXT...
* Docs can be kept in shape in a presentable format with QA.
That was an aside, but I thought I'd share. So basically, documentation
shouldn't be thought about wrt. the new site. At the moment, I feel we
have the following choices:
* Mediawiki[2]: Another wiki. I personally don't like Mediawiki for a
number of reasons, but I won't let that cloud my judgement. I
already mocked up a new SynCE site with MW[3] a long time ago, but
it doesn't quite reflect the newer idea of not having the docs on it
anymore! But you can get a taste from it!
* MoinMoin[4]: Yet another wiki. However, I personally thing MoinMoin
is the wiki king. However, some think that its /bland/ look is
off-putting. I understand where they are coming from. For example,
bazaar has done a great job[5] at making their MoinMoin installation
work well. A good example of MoinMoin working as a main site
interface is the MoinMoin project website[4].
* Trac[6]: This /could/ potentially work very well, and link into the
SourceForge SVN server. This would mean another, not necessarily
bad, change: Migration from SF bug-tracker to Trac. The style
argument might also apply, but again magic can indeed happen as
Twisted[7] show.
* Static site: This is of course another possibility. I could throw
something together with something like Django.
I'd like to know what peoples' thoughts on this are. Bear in mind that
this also involves me setting it up :D
Many regards,
[0] http://synce.sourceforge.net/
[1] http://www.synce.org/
[2] http://www.mediawiki.org/
[3] http://jonnylamb.no-ip.org/~jonny/synce/
[4] http://moinmoin.wikiwikiweb.de
[5] http://bazaar-vcs.org/
[6] http://trac.edgewall.org/
[7] http://twistedmatrix.com/trac/
I am currently trying to upgrade the website. What I want to achieve is
move completely from the old website[0] on SourceForge to the synce.org
website[1]. However, the latter also needs an upgrade as the wiki is
getting heavily laden, becoming harder to navigate, and getting
out-of-date.
The idea is not to have documentation on the website but in docbook for
the following reasons:
* Docs can be read off-line.
* Docs are easier to be printed.
* Docs are in many different formats -- HTML (chunk/all), PDF, TXT...
* Docs can be kept in shape in a presentable format with QA.
That was an aside, but I thought I'd share. So basically, documentation
shouldn't be thought about wrt. the new site. At the moment, I feel we
have the following choices:
* Mediawiki[2]: Another wiki. I personally don't like Mediawiki for a
number of reasons, but I won't let that cloud my judgement. I
already mocked up a new SynCE site with MW[3] a long time ago, but
it doesn't quite reflect the newer idea of not having the docs on it
anymore! But you can get a taste from it!
* MoinMoin[4]: Yet another wiki. However, I personally thing MoinMoin
is the wiki king. However, some think that its /bland/ look is
off-putting. I understand where they are coming from. For example,
bazaar has done a great job[5] at making their MoinMoin installation
work well. A good example of MoinMoin working as a main site
interface is the MoinMoin project website[4].
* Trac[6]: This /could/ potentially work very well, and link into the
SourceForge SVN server. This would mean another, not necessarily
bad, change: Migration from SF bug-tracker to Trac. The style
argument might also apply, but again magic can indeed happen as
Twisted[7] show.
* Static site: This is of course another possibility. I could throw
something together with something like Django.
I'd like to know what peoples' thoughts on this are. Bear in mind that
this also involves me setting it up :D
Many regards,
[0] http://synce.sourceforge.net/
[1] http://www.synce.org/
[2] http://www.mediawiki.org/
[3] http://jonnylamb.no-ip.org/~jonny/synce/
[4] http://moinmoin.wikiwikiweb.de
[5] http://bazaar-vcs.org/
[6] http://trac.edgewall.org/
[7] http://twistedmatrix.com/trac/
--
Jonny Lamb, UK ***@jonnylamb.com
http://jonnylamb.com GPG: 0x2E039402
Jonny Lamb, UK ***@jonnylamb.com
http://jonnylamb.com GPG: 0x2E039402