You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@mina.apache.org by Coding Horse <zh...@hotmail.com> on 2007/03/05 18:07:10 UTC
Re: [VOTE] What tutorials do we need sooner?
Some terminology/concepts like "Future", "Excecutor" that is obvious to mina
developers may be never-heard to a beginning mina user like me. I've been
reading whatever mina text I could find for a few days without knowing
"Future" is a standard interface in JDK 1.5.
I hope I would have read the whole page of Future javadoc before guessing
the meaning of the one-liner javadoc of mina's IoFuture javadoc.
MINA is such a great thing that it deserves much more effort on
documentation side. Thx.
--
View this message in context: http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9315708
Sent from the mina dev mailing list archive at Nabble.com.
Re: [VOTE] What tutorials do we need sooner?
Posted by Mark Webb <el...@gmail.com>.
disagree
On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>
>
> I'm quite sure 90% of current java programmers, like me, will think
> "tomorrow" instead of "a standard interface" when you tell him/her "Future
> in Java". But to understand mina one must know Future interface.
> --
> View this message in context:
> http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9316905
> Sent from the mina dev mailing list archive at Nabble.com.
>
>
--
..Cheers
Mark
Re: [VOTE] What tutorials do we need sooner?
Posted by Coding Horse <zh...@hotmail.com>.
I'm quite sure 90% of current java programmers, like me, will think
"tomorrow" instead of "a standard interface" when you tell him/her "Future
in Java". But to understand mina one must know Future interface.
--
View this message in context: http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9316905
Sent from the mina dev mailing list archive at Nabble.com.
Re: [VOTE] What tutorials do we need sooner?
Posted by Mark Webb <el...@gmail.com>.
I completely agree. No reason to re-invent the wheel. We should just
reference a couple of the better tutorials out there.
On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>
>
> I found mina community did very well in answering questions. It'll also
> be
> much helpful for beginners to quick understand/start using mina if there
> is
> an introduction article(tutorial?) summarizing(and referring to) important
> concepts like "Future", "Excecutor", "Filter" etc. Then it'll be easier
> to
> understand Trusin's tutorial.
>
>
> Mark Webb-4 wrote:
> >
> > While I agree that MINA is a great system, and the documentation needs
> > help,
> > I am not sure that the MINA documentation should support tutorials on
> Java
> > I/O and networking. Maybe we should just provide links to sites that
> > already provide good documentation on these subjects.
> >
> >
> >
> > On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
> >>
> >>
> >> Some terminology/concepts like "Future", "Excecutor" that is obvious to
> >> mina
> >> developers may be never-heard to a beginning mina user like me. I've
> >> been
> >> reading whatever mina text I could find for a few days without knowing
> >> "Future" is a standard interface in JDK 1.5.
> >>
> >> I hope I would have read the whole page of Future javadoc before
> guessing
> >> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
> >>
> >> MINA is such a great thing that it deserves much more effort on
> >> documentation side. Thx.
> >>
> >>
> >> --
> >> View this message in context:
> >>
> http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9315708
> >> Sent from the mina dev mailing list archive at Nabble.com.
> >>
> >>
> >
> >
> > --
> > ..Cheers
> > Mark
> >
> >
>
> --
> View this message in context:
> http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9316682
> Sent from the mina dev mailing list archive at Nabble.com.
>
>
--
..Cheers
Mark
Re: [VOTE] What tutorials do we need sooner?
Posted by Coding Horse <zh...@hotmail.com>.
I found mina community did very well in answering questions. It'll also be
much helpful for beginners to quick understand/start using mina if there is
an introduction article(tutorial?) summarizing(and referring to) important
concepts like "Future", "Excecutor", "Filter" etc. Then it'll be easier to
understand Trusin's tutorial.
Mark Webb-4 wrote:
>
> While I agree that MINA is a great system, and the documentation needs
> help,
> I am not sure that the MINA documentation should support tutorials on Java
> I/O and networking. Maybe we should just provide links to sites that
> already provide good documentation on these subjects.
>
>
>
> On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>>
>>
>> Some terminology/concepts like "Future", "Excecutor" that is obvious to
>> mina
>> developers may be never-heard to a beginning mina user like me. I've
>> been
>> reading whatever mina text I could find for a few days without knowing
>> "Future" is a standard interface in JDK 1.5.
>>
>> I hope I would have read the whole page of Future javadoc before guessing
>> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
>>
>> MINA is such a great thing that it deserves much more effort on
>> documentation side. Thx.
>>
>>
>> --
>> View this message in context:
>> http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9315708
>> Sent from the mina dev mailing list archive at Nabble.com.
>>
>>
>
>
> --
> ..Cheers
> Mark
>
>
--
View this message in context: http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9316682
Sent from the mina dev mailing list archive at Nabble.com.
Re: [VOTE] What tutorials do we need sooner?
Posted by Mark Webb <el...@gmail.com>.
While I agree that MINA is a great system, and the documentation needs help,
I am not sure that the MINA documentation should support tutorials on Java
I/O and networking. Maybe we should just provide links to sites that
already provide good documentation on these subjects.
On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>
>
> Some terminology/concepts like "Future", "Excecutor" that is obvious to
> mina
> developers may be never-heard to a beginning mina user like me. I've been
> reading whatever mina text I could find for a few days without knowing
> "Future" is a standard interface in JDK 1.5.
>
> I hope I would have read the whole page of Future javadoc before guessing
> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
>
> MINA is such a great thing that it deserves much more effort on
> documentation side. Thx.
>
>
> --
> View this message in context:
> http://www.nabble.com/What-tutorials-do-we-need-sooner--tf3270969.html#a9315708
> Sent from the mina dev mailing list archive at Nabble.com.
>
>
--
..Cheers
Mark
Re: [VOTE] What tutorials do we need sooner?
Posted by Stanczak Group <ju...@stanczakgroup.com>.
The ones under documentation on the site.
Mark Webb wrote:
> which slides?
>
> On 3/6/07, Stanczak Group <ju...@stanczakgroup.com> wrote:
>>
>> I think that that graphic from the slides that shows the flow of MINA
>> (at a glance slide 12) would be great on the site with more detail.
>> Maybe that could cover the terminology some. Maybe create an image map
>> with fly-outs showing detail of use.
>>
>> robert burrell donkin wrote:
>> > On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>> >>
>> >> Some terminology/concepts like "Future", "Excecutor" that is obvious
>> >> to mina
>> >> developers may be never-heard to a beginning mina user like me. I've
>> >> been
>> >> reading whatever mina text I could find for a few days without
>> knowing
>> >> "Future" is a standard interface in JDK 1.5.
>> >>
>> >> I hope I would have read the whole page of Future javadoc before
>> >> guessing
>> >> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
>> >
>> > MINA has quite a lot of terminology so a glossary would be useful
>> > (linking to fully explanations both on site and elsewhere)
>> >
>> > - robert
>> >
>>
>> --
>> Justin Stanczak
>> Stanczak Group
>> 812-735-3600
>>
>> "All that is necessary for the triumph of evil is that good men do
>> nothing."
>> Edmund Burke
>>
>>
>
>
--
Justin Stanczak
Stanczak Group
812-735-3600
"All that is necessary for the triumph of evil is that good men do nothing."
Edmund Burke
Re: [VOTE] What tutorials do we need sooner?
Posted by Mark Webb <el...@gmail.com>.
which slides?
On 3/6/07, Stanczak Group <ju...@stanczakgroup.com> wrote:
>
> I think that that graphic from the slides that shows the flow of MINA
> (at a glance slide 12) would be great on the site with more detail.
> Maybe that could cover the terminology some. Maybe create an image map
> with fly-outs showing detail of use.
>
> robert burrell donkin wrote:
> > On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
> >>
> >> Some terminology/concepts like "Future", "Excecutor" that is obvious
> >> to mina
> >> developers may be never-heard to a beginning mina user like me. I've
> >> been
> >> reading whatever mina text I could find for a few days without knowing
> >> "Future" is a standard interface in JDK 1.5.
> >>
> >> I hope I would have read the whole page of Future javadoc before
> >> guessing
> >> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
> >
> > MINA has quite a lot of terminology so a glossary would be useful
> > (linking to fully explanations both on site and elsewhere)
> >
> > - robert
> >
>
> --
> Justin Stanczak
> Stanczak Group
> 812-735-3600
>
> "All that is necessary for the triumph of evil is that good men do
> nothing."
> Edmund Burke
>
>
--
..Cheers
Mark
Re: [VOTE] What tutorials do we need sooner?
Posted by Stanczak Group <ju...@stanczakgroup.com>.
I think that that graphic from the slides that shows the flow of MINA
(at a glance slide 12) would be great on the site with more detail.
Maybe that could cover the terminology some. Maybe create an image map
with fly-outs showing detail of use.
robert burrell donkin wrote:
> On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>>
>> Some terminology/concepts like "Future", "Excecutor" that is obvious
>> to mina
>> developers may be never-heard to a beginning mina user like me. I've
>> been
>> reading whatever mina text I could find for a few days without knowing
>> "Future" is a standard interface in JDK 1.5.
>>
>> I hope I would have read the whole page of Future javadoc before
>> guessing
>> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
>
> MINA has quite a lot of terminology so a glossary would be useful
> (linking to fully explanations both on site and elsewhere)
>
> - robert
>
--
Justin Stanczak
Stanczak Group
812-735-3600
"All that is necessary for the triumph of evil is that good men do nothing."
Edmund Burke
Re: [VOTE] What tutorials do we need sooner?
Posted by robert burrell donkin <ro...@gmail.com>.
On 3/5/07, Coding Horse <zh...@hotmail.com> wrote:
>
> Some terminology/concepts like "Future", "Excecutor" that is obvious to mina
> developers may be never-heard to a beginning mina user like me. I've been
> reading whatever mina text I could find for a few days without knowing
> "Future" is a standard interface in JDK 1.5.
>
> I hope I would have read the whole page of Future javadoc before guessing
> the meaning of the one-liner javadoc of mina's IoFuture javadoc.
MINA has quite a lot of terminology so a glossary would be useful
(linking to fully explanations both on site and elsewhere)
- robert