Discussion:
[Synce-devel] SynCE website
Jonny Lamb
2007-06-03 14:58:02 UTC
Permalink
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/
--
Jonny Lamb, UK ***@jonnylamb.com
http://jonnylamb.com GPG: 0x2E039402
Jonny Lamb
2007-06-03 15:08:20 UTC
Permalink
Post by Jonny Lamb
* 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].
I have also started a MoinMoin installation for SynCE for all to look
and judge at:

http://www.synce.org/moin/

Of course, it's no-where near finished. However, I'd prefer to decide on
one website to use and then develop that, as opposed to developing all
these mock-ups :D
Post by Jonny Lamb
* 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.
Also another thing regarding the theme thing. I just had a tiny peek on
t'internet about themes for Trac, and although there are very few, they
are actually of very high quality. For example:

http://www.trac-hacks.org/wiki/PyDotOrgTheme

Another thing -- If someone mocks up a nice theme that we all like,
I'll be more than willing to make it into a proper
Trac/MoinMoin/MediaWiki skin (or of course use it in a static site, if
that's what's popular).
--
Jonny Lamb, UK ***@jonnylamb.com
http://jonnylamb.com GPG: 0x2E039402
Dr J A Gow
2007-06-05 22:35:28 UTC
Permalink
Post by Jonny Lamb
Post by Jonny Lamb
* 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].
I have also started a MoinMoin installation for SynCE for all to look
http://www.synce.org/moin/
I must admit I quite like the uncluttered look of this interface

John.

Continue reading on narkive:
Loading...