Hi folks, I'm a tech writer with FastMail and I'm here to help.
Here's my plan to organise the (many and flavourful) varieties of documentation surrounding the Cyrus imap universe. Please speak up if you have thoughts/ideas/objections! *The Goal* Make the content on docs.cyrus.foundation the authoritative source for all things Cyrus Imap/Sasl. (The server/websitename will be changing at some point, but we still need the content in one spot) *The Plan* Migrate content from cyrusimap mediawiki, where appropriate. Update as necessary. Absorb relevant content lurking on git.cyrus.foundation's wiki (specifically the developer setup/install guide) Update cyrusimap.org/cyrussasl.org to just point people at docs.cyrus.foundation *Doc structure* So what should the new docs.cyrus.foundation look like? Much as it does now, just with more! Home * What is Cyrus * About the Cyrus Foundation (what, who, history, bylaws) * Latest news * Features (roadmap) Download * Beta, Stable, Old * Pointers to Docs/Install guides Documentation * Contributor (Set up your dev env, prerequisites, obtaining source and libraries, building, verifying, gotchas, faq) * Administrator (installation, verification, customisation, operation, faq, man pages) Support * Contact (irc, mailing list) * Bug reports And generally making it more pretty - cyrusimap has an icon and colour scheme which presumably could be brought over to docs.cyrus.foundation which currently looks stylistically sparse. Nic (onlight) seems to have a good handle on bringing the man pages up to date and ensuring they're current at docs.cyrus.foundation, which is great. (cyrus-docs/source/imap/admin/commands and in cyrus-imap/man both contain man pages) *Questions* Is someone able to upgrade my privileges so I can commit changes to the cyrus-docs tree? (*Jeroen?*) Does the new site need copyright content across it (a la cyrusimap which refers to CMU). If so, what do we need? Currently it just says copyright "The Cyrus Team". What's the process for pushing a new batch of docs onto docs.cyrus.foundation once they're written? What else am I missing? Cheers, Nicoloa
