Re: [akka-user] documentation tickets

2014-04-24 Thread Patrik Nordwall
On Thu, Apr 24, 2014 at 12:04 PM, Tim Pigden wrote: > Hi > Guidelines say not to start work until the ticket has been reviewed. Is > that necessary here? > Go ahead, guidelines are not rules. I think the purpose of that is to agree on bigger features. > > > On Thursday, April 24, 2014 10:08:50

Re: [akka-user] documentation tickets

2014-04-24 Thread Tim Pigden
Hi Guidelines say not to start work until the ticket has been reviewed. Is that necessary here? On Thursday, April 24, 2014 10:08:50 AM UTC+1, Patrik Nordwall wrote: > > Hi Tim, > We appreciate such improvements very much. Please open ticket and if > possible a pull request fixing the issue. >

Re: [akka-user] documentation tickets

2014-04-24 Thread Patrik Nordwall
On Thu, Apr 24, 2014 at 11:14 AM, Tim Pigden wrote: > Are there rules for the docs? > For example - what if my searches have found an excellent blog article on > the topic? Can I reference it? > The documentation is versioned to a specific Akka version and it could be a problem that the blog pos

Re: [akka-user] documentation tickets

2014-04-24 Thread Konrad Malawski
Hello Tim! I think the docs should be mostly "self contained" - as in, if I'm in the woods in Laponia with no WiFi, with the docs downloaded, I should be able to figure out what I need from the docs :-) You are very welcome to open issues and pull requests! -- Cheers, Konrad 'ktoso' Malawski hAk

Re: [akka-user] documentation tickets

2014-04-24 Thread Tim Pigden
Are there rules for the docs? For example - what if my searches have found an excellent blog article on the topic? Can I reference it? Or a discussion thread here? Or a chapter in one of the books? (I'm sure the authors would be happy for a plug) On 24 April 2014 10:08, Patrik Nordwall wrote:

Re: [akka-user] documentation tickets

2014-04-24 Thread Patrik Nordwall
Hi Tim, We appreciate such improvements very much. Please open ticket and if possible a pull request fixing the issue. Regards, Patrik On Thu, Apr 24, 2014 at 11:03 AM, Tim Pigden wrote: > In reading the documentation there may be things that could be more > usefully described. > > Example on t

[akka-user] documentation tickets

2014-04-24 Thread Tim Pigden
In reading the documentation there may be things that could be more usefully described. Example on the EventBus page all extend EventBus but actually duplicate the code from trait ActorEventBus extends EventBus { type Subscriber = ActorRef protected def compareSubscribers(a: ActorRef, b: A