[ANNOUNCE] A fresh new website in the course
nicolas.s-dev at laposte.net
Tue Mar 10 17:06:43 GMT 2015
I'm almost done with the construction of a new website.
This is something we've always been far behind other's projects.
Everybody has a fancy website while ours still looks like coming out
from the 80's... :-(
Honestly, I have big respect for the site at offlineimap.org. This is
one-guy made and almost nobody volunteered to enter the dance despite
OTOH, I fully understand. I'm myself reluctant to update it because it's
not trivial nor attractive. So yes, I'd like to deprecate and kill it,
in favour of the latest built.
The idea is to focus on only 3 sites, make them as open as possible and
stop with the big joke of having fragmented and duplicated documentation
everywhere, without a beginning of logic in the frame.
Hence, I propose the following structure:
- http://github.com/OfflineIMAP/offlineimap remains our main site.
It's dedicated to tracking the sources, issues, contributions, etc.
- the wiki at https://github.com/OfflineIMAP/offlineimap/wiki
Usefull to get the wider audiance, support big changes while
developing and bookmark some tips/TODO.
I believe it should be easier to update everybody has the possibility
to work on it with Git and his own editor. Traking the sources is made
open with https://github.com/OfflineIMAP/offlineimap-wiki so everybody
can send pull requests.
- http://offlineimap.github.io/offlineimap becomes our community's website.
It deprecates both the current http://offlineimap.org and
http://offlineimap.github.io/offlineimap (the github gh-pages we made
while migrating to the organization at Github a loooong time ago).
It must be usefull and handle the user and developers documentation
- installation guide
- quick start
- configuration examples
- the FAQ
- advanced configuration gathered since the begining
- the Changelogs
- the sphinx APIs
... and more.
It aims to become as attractive as possible with
- the blog, where everybody is welcome to post in
- the screenshots
It intend to rely on well-known tools, easy to use and widely adopted
in order to keep fun
- markdown/kramdown syntax
- Font Awesome
- A bit of jQuery
This goal was obviously the great opportunity to deeply refactorize the
documentation. I already did 80-90% of the work.
Because a lot of changes are still pending in the 'next' branch, the
current status does not reflect the real WIP. Docmentation at
offlineimap.git is still not checked-out on the page.
But before going any further and announce the definitive direction we
take, I'd like to get your feedbacks on this.
If most agree, I'll roll it out in the coming - not so far - v6.5.7
Happy surf! ,-)
More information about the OfflineIMAP-project