Thanks a lot for all the replies.. Since the documents should be good user 
manual but not purely documents for the developed technologies from the 
developers' perspectives. It could be good if the docs start by a "Get 
Started" section (including how to install, configure) to firstly make it 
runnable. Followed by a 
1) high level architecture/structure for the main classes/concepts *or *
2) even the background knowledge for the programming model
would be necessary for a general user manual. not all the beginners have 
enough background to start using a new toolkit.
also, the manual should be third party libraries/tools independent, why 
should a new-comer for Akka know sbt and scala but not maven/gradle and 
python, etc(since you claim that Akka is also available for Java 
developers, not all java developers have the same tools in their 
toolboxes). The user manual should be completely independent from the usage 
of such tools which only brings the beginners difficulties to contextualize.

BTW, currently I'm using  "Akka in Action" and also "Applied Akka 
Patterns", especially the latter book, makes me get some feelings about 
Akka. Actually it's good to 
1) start from "Applied Akka Patterns", knowledge about Actor Models 
2) then combine with Akka official documents, "Akka in Action" and Akka API 
docs 
to learn Akka.

Best regards,

On Thursday, 19 January 2017 20:41:08 UTC+1, Josep Prat wrote:
>
> Welcome to Akka!
> As Lutz already said, I would recommend "Akka in Action". The only catch 
> is that the code is mainly in Scala.
> I have a question though, why do you say the official documentation is 
> terrible? I personally find Akka docs quite good. What would you change/add 
> to the current ones?
>
> Best,
> Josep
>
> On Thursday, January 19, 2017 at 2:34:29 PM UTC+1, Qian Liu wrote:
>>
>> Hello everybody,
>>
>> I'm new-comer to Akka, the official documents for Akka learning is 
>> terrible. not very well structured. Beginners will soon feel lost with 
>> these official documents. Do you know any better resources to learn? I'm a 
>> java developer.
>>
>> Thanks a lot.
>>
>> Best regards,
>>
>> Qian Liu
>>
>

-- 
>>>>>>>>>>      Read the docs: http://akka.io/docs/
>>>>>>>>>>      Check the FAQ: 
>>>>>>>>>> http://doc.akka.io/docs/akka/current/additional/faq.html
>>>>>>>>>>      Search the archives: https://groups.google.com/group/akka-user
--- 
You received this message because you are subscribed to the Google Groups "Akka 
User List" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/akka-user.
For more options, visit https://groups.google.com/d/optout.

Reply via email to