Akka HTTP call for all - Githubissues

ktoso commented 7 years ago

Hi hakkers, we'd like to have another free-for-all Akka HTTP call.

Anyone who's interested in developing Akka HTTP is welcome to join.

Time:

February, 22nd 17:00 CET
Join the hangout
Watch

Johannes knows everything there is to know about plans and codebase etc, so I don't think there's a need to delay it just because I'm away - we wanted to hold this call since January but travel made it too tricky.

Topics:

Lightbend team update, what we'll focus on, and roadmap etc
- We'll talk about HTTP/2 plans and timing, we'll work with Play team more closely together soon to get Akka HTTP as the engine in there - Konrad or Johannes
getting started / docs improvements, how to go about it - Josep
declarative parsing / streaming - Jan
simple high-level client infrastructure - gosubpl
[your topic here, please propose below]

Let us know what time and topics would work for you! The call will be on google hangouts and free to join for anyone who wants to.

ktoso commented 7 years ago

cc @jrudolph @akka/akka-http-team @jlprat @gosubpl

jducoeur commented 7 years ago

I'll probably mostly lurk, but am interested in listening in -- please keep me in the loop. Either day currently looks clear for me.

jlprat commented 7 years ago

I think I can make it on the 22nd. On the 1st, unfortunately, I can't because of work.

jlprat commented 7 years ago

One topic I would like to bring in is about improving the "getting started" moment. Akka documentation in general has been always good once you know a bit about the project, but it generally lacks when somebody with no prior knowledge of it comes to the project. This was broad up in the akka-user group list (it was about akka, but I think it also can apply to akka-http), you can check the discussion here

What about improving on this area? It could be done through tutorials, project templates, quick introduction guides.

jypma commented 7 years ago

Either would work for me. I plan on not getting ill this time :-) If I succeed, I can finally talk a bit about the declarative marshalling DSL and reactive XML+JSON parser stuff I was hoping to pull in from ts-reaktive.

jducoeur commented 7 years ago

+1 to @jlprat's observation. A few years ago, I was able to point folks to Activator templates to learn various aspects, but Activator seems to have lost steam, and I'm not sure we can rely on it any more...

ktoso commented 7 years ago

You'll be happy to hear the getting started experience is actually our top priority in the coming period (Lightbend-wise). Closely followed by HTTP/2 and other cool things :-) So yeah, we'll definitely invest in a docs re-structuring / re-theming and general improvements - let's brainstorm in the call what we can do.

gosubpl commented 7 years ago

For me both dates would work fine but I prefer the 22nd. In the 'getting started' vein I would like to discuss the possibility of adding a simple client like the one Spray has (has had :) ). This would simplify porting spray -> akka-http on projects that heavily use client in testing (e.g. mesosphere's marathon). I would also like to talk about HTTP/2.

ktoso commented 7 years ago

Note: Let's do the call on the 22nd, next week then.

Simple client is a good discussion point - I feel we should help Play's WS (which has become a standalone thing) become awesome instead

ShaneDelmore commented 7 years ago

From a getting started with Akka-Http from Spray perspective I think the docs around migrating authentication could be improved. I found most of the migration easy but the authentication more difficult as the names and types had changed so much with no reference in the new codebase to the old types. A simple table of spray to Akka mappings like "Spray ContextAuthenticator => AkkaHttp ... would save users time when upgrading, especially since so much is practically free if you know the old to new imports to replace.