mina-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Ricardo Dias Sales (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DIRMINA-969) Rewriting the users guide.
Date Thu, 07 Nov 2013 02:12:19 GMT

    [ https://issues.apache.org/jira/browse/DIRMINA-969?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13815561#comment-13815561
] 

Ricardo Dias Sales commented on DIRMINA-969:
--------------------------------------------

Hi!

I think we should try to create a new material about the project. I really think that the
content will be better. But as we are still at the beginning, it may not be good to modify
anything on the site. Instead, it would be interesting to warn users about the news that we
are working on a new documentation. The last thing I want you to think, is that the previous
documentation was not worth to writing. Do not think so! If the past material was not available,
the new one could never exist, and we do not know what will be the end result of the new documentation.
Of course this is just my suggestion. I'm developing the next part of the new documentation.
I think when we complete everything, we can together decide what to do. Maybe it's too early
to decide this. As I said before, this is just my opinion. What do you guys think?

Talking about the next part, I'm writing about the MINA services. I would like to know more
about the IoServiceListener interface. For example, the description of the method serviceActivated
says the following:

"Invoked when a new service is activated by an IoService."

Does this means that this type of event is only triggered when a service is only activated
by another service? For example, I have a IoService A and a IoService B. It is necessary that
A activate B, or B activate A to this type of event get triggered? Or whenever any block of
code activate a IoService this event will be fired?

Thanks for the help! :)

Ricardo.


> Rewriting the users guide.
> --------------------------
>
>                 Key: DIRMINA-969
>                 URL: https://issues.apache.org/jira/browse/DIRMINA-969
>             Project: MINA
>          Issue Type: Improvement
>          Components: Web Site / Documentation
>    Affects Versions: 2.0.7
>            Reporter: Ricardo Dias Sales
>         Attachments: MINA 2 - CHAP 1 [ENG].docx
>
>
> Hello
> My name is Ricardo and I live in Brazil. A few days ago I was looking for a solution
for developing enterprise applications on the network. Much has happened, and I found the
session "user guide" website was outdated. I've been talking to one of the members of the
project, Emmanuel Lécharny, and ended up volunteering myself to try to update the site documentation
as I can.
> I do not know of much of MINE, but I believe I can help to improve part of the documentation.I
actually made ​​a new first chapter so that new users can get an introduction to the framework.
Honestly speaking, I love the project MINA, and I believe that the lack of sufficient documentation
is causing the community of developers to reject MINA and use it as an option in their projects.
That's why I believe this is an important issue that must be dealt with seriously. 
> Unfortunately I am newbie in JIRA, and do not know how to use it. Emmanuel recommended
me create an issue so we can work together in the development of new study material. How do
I show here what I've done? Thanks for listening, and sorry for my cluelessness about using
JIRA.
> EDIT: Oh! I found how to add attachments here. I'm putting so a Microsoft Word document
about the first chapter that I did. I hope that suits you. And anyway, I accept criticism
without the slightest problem.
> Ricardo.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Mime
View raw message