Session description
There are many aspects to consider when building a GraphQL API: Authentication, authorization, performance, schema design, and team workflow to name a few. Each aspect encompasses considerations, practices, and tools (or lack thereof). One aspect, documentation, can be easily neglected. At The Guild we are building an open source tool called Polen to address this. It aims to make beautiful developer portals easy and reduce the gap of docs tools between GraphQL and REST communities.
This presentation would mark the first formal introduction of Polen, covering:
1. How/why Polen came to be
2. What it does so far
3. What it could do in the future
This talk would continue the larger docs conversation (e.g. last year www.youtube.com/watch?v=kWe_v6YVj8U) by sharing what encoding some of our best docs ideas into tooling could look like. Ideally it would help the audience think about how they can make their APIs more accessible for their users. Finally, given Polen is not a commercial offering, I also hope to inspire people to get involved, make issues, give feedback, and send pull requests.
Polen is already public today at github.com/the-guild-org/polen
