mina-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alex Karasulu <aok...@bellsouth.net>
Subject Re: Docs? Please?
Date Sun, 29 Oct 2006 18:14:56 GMT
Jeroen Brattinga wrote:
> You're right. I've signed up for Confluence and will send the fax to help
> correct this issue. Documentation is -by far- the biggest stumbling block
> for Mina. It almost put me off in the beginning; I'm still glad I stuck
> though :-)

Awesome! Documentation is just as important as the code if you ask me. 
It's good to have folks like yourself stand up and volunteer for the task.

Ersin can hook you up with access after I see that your CLA has been 
filed and we can get you moving.

Thanks,
Alex



> 
> Jeroen Brattinga
> 
> 2006/10/29, Jeff Schnitzer <jeff@infohazard.org>:
>>
>> Just to inject a quick reality-check...
>>
>> No matter what you want to call your next version, the existing 1.0
>> release is fatally broken.
>>
>> The code seems to be fine, but both the packaged docs and the online
>> documentation describe something significantly different from the
>> software included in the release.  I can't tell if the docs describe an
>> older version of the software or a newer version of the software.
>>
>> We'd really like to convert our popular SMTP server library
>> (http://subethasmtp.tigris.org/) over to MINA but the threading
>> explanation seems to be wildly off.  It's a shame because MINA looks
>> great and we've already converted over the postfix tcptables
>> implementation in SubEtha Mail.  The library is great - you'd probably
>> get 10X more adoption if the docs weren't obviously wrong.
>>
>> Thanks,
>> Jeff
>>
>> P.S.  Just because I can't resist bicycle sheds... the even/odd release
>> numbering is dumb.  Everyone who has ever used a Microsoft product
>> (read: everyone) knows that X.0 releases are far less stable and mature
>> than X.1 releases.  Just call it 2.0 and release it soon - with correct
>> docs and all jar dependencies.
>>
> 


Mime
View raw message