Cyrus 2.5 documentation

[Chris Davies]

Just a few thoughts on the 2.5 documentation and Cyrus websites:

-It isn't obvious what website users should go to
http://www.cyrus.foundation or http://www.cyrusimap.org? Do we need
two websites?

-http://www.cyrus.foundation redirects to https://cgit.cyrus.foundation/
and doesn't have an obvious link to http://docs.cyrus.foundation. Should
I be testing against docs.cyrus.foundation or the cyrusimap.org
documentation?

-http://cyrusimap.org/docs/cyrus-imapd/2.5.0/ The page title for 2.5.0
help docs is 'Cyrus IMAP Server, version 2.4'.

-Cyrusimap.org : "*© 1999-2010 Carnegie Mellon University. All Rights
Reserved.*". Should this be updated to 2015? and mention the Cyrus
foundation?

-http://www.cyrusimap.org/mediawiki/index.php/Downloads#IMAP_Server
"*The latest stable/current release of the IMAP server is 2.4.16*". Is
this now 2.5?

-I've downloaded the latest version from cyrusimap.org (2.5.0). The
README file inside cyrus-imapd-2.5.0.tar.gz says "*The 2.4 series
contains numerous features*". Should this say 2.5?

-/home/tester/Downloads/cyrus-imapd-2.5.0/README.andrew : "# This is
internal documentation for Computing Services at
# Carnegie Mellon University.
#
# Please refer to doc/readme.html for the 'real' README. "

Should this file be placed elsewhere?

-/home/tester/Downloads/cyrus-imapd-2.5.0/doc/readme.html broken link
'*creation and deletion of users*', points to a non-existing file
file:///home/tester/Downloads/cyrus-imapd-2.5.0/doc/cyradm.1.html

-The help docs for 2.5 aren't visible without scrolling down. Could we
reverse the order so the newest ones appear at the top of the list?



-CyrusImap.org broken links:

http://cyrusimap.org/docs/cyrus-imapd/2.5.0/ "Internal Documentation"
points to http://cyrusimap.org/docs/cyrus-imapd/2.5.0/internal/index.php


http://cyrusimap.org/mediawiki/index.php/FAQ points to :
http://cyrusimap.web.cmu.edu/imapd/internal/mailbox-format.html which
returns a 404. The oracle links on this page are also broken:
> Update, 2007/07/09: They've moved since sleepycat got bought by
Oracle (did they really I wonder, I heard something about this, and
their site seems to have moved....) Anyway, I found the pages
listed above:


>  * http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/envset_lk_max_lockers.html
>  * http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/envset_lk_max_locks.html
>  * http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/envset_lk_max_objects.html

http://cyrusimap.org/docs/cyrus-imapd/2.5.0/specs.php has a broken link
to '[MS-NTHT] NTLM Over HTTP Protocol Specification'
http://download.microsoft.com/download/a/e/6/ae6e4142-aa58-45c6-8dcf-a657e5900cd3/%5BMS-NTHT%5D.pdf

http://cyrusimap.org/docs/cyrus-imapd/2.5.0/man.php Most of the links on
this page are broken


Cheers, Chris

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.andrew.cmu.edu/pipermail/cyrus-devel/attachments/20150422/f154047d/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: converted_image1.png
Type: image/png
Size: 475629 bytes
Desc: not available
Url : http://lists.andrew.cmu.edu/pipermail/cyrus-devel/attachments/20150422/f154047d/attachment-0001.png