Is GraphQL Really "Self-documenting"? | James Scott | API the Docs London 2018
Channel: API the Docs
Date: 2018-12-14

Is GraphQL Really "Self-documenting"? by James Scott at API the Docs London 2018

Talk Description:

As GraphQL continues to emerge in the API space, an increasing number of advocates have lauded it for being “self-documenting” or “self-descriptive”. Some have even gone as far as to say GraphQL doesn’t need documentation.

I want to debunk this “self-documenting” myth, explain the importance of naming in GraphQL; something co-creator Lee Byron has promoted himself, and share why I think technical writers still have an important role to play in its documentation.

API the Docs London 2018 recaps: https://pronovix.com/event/api-docs-london-2018

---

API the Docs is an event for tech writers, API developers, product owners and developer evangelists who embrace documentation as a crucial aspect of a great developer experience. The conference is a great opportunity to share and discuss the latest best practices, strategies and new trends relevant to API documentation and developer portals.

Website: https://apithedocs.org

Sign up here for notifications on upcoming events, discount codes, recaps, etc:  http://bit.ly/apithedocs