Don't rest on REST (Swagger)

[niklas-heer]

• Speaker: Fabian (@Akuryou) & Niklas (@niklas-heer)
• Duration: 15m (Introduction to REST) + 30m (Swagger)
• Slides: http://akuryou.github.io/introduction-to-swagger/ (some)
• Description: Frist we dive into what REST is and talk about some best practices. Than it'll be all about Swagger. We will show you how the tool works and why it is pretty cool.

(ref: #12)

[stesie]

... GraphQL would also make for a nice session, wouldn't it?

[niklas-heer]

@stesie true. Should it be a separate session or should the speaker decide what he/she wants to talk about?

[stesie]

@niklas-heer I think both are large enough topics, and distinct fields. So even if one speaker wants to do both, merely session time suggests to split it both up.

And also to have the "hands on" part focussed

[niklas-heer]

@stesie good point. I'll create a second issue.

[Akuryou]

Got a talk about swagger and useful related libraries. But it does not cover REST basics and best practices.

http://akuryou.github.io/introduction-to-swagger/

[niklas-heer]

@Akuryou That's very cool. We could do a collaboration and I could briefly cover the basics and some best practices. After that you could dive deeper into Swagger. What do you think?

[Akuryou]

Actually there is often a lot of confusion about what REST really is. Most people think REST == "Some API I call via HTTP". Which is very far from the truth.

Therefore I think an additional talk about what REST really is might be good.

[niklas-heer]

Awesome so I change the issue accordingly and then it's open for votes.

[niklas-heer]

I've updated the main issue. :smiley:

We will rock it together @Akuryou! :muscle:

[proudcommerce]

a pity ... sitting at the airplane in this time :-(

[niklas-heer]

@proudcommerce That's really unfortunate timing. But there is an issue for GraphQL. So it won't be the last talk about APIs. :)

[niklas-heer]

Closing the talk. Here are the slides: https://github.com/dev-night/talks/tree/master/slides/2017/012_dont-rest-on-rest