Is GraphQL Really "Self-documenting"? | James Scott | API the Docs London 2018
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
Видео Is GraphQL Really "Self-documenting"? | James Scott | API the Docs London 2018 канала API the Docs
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
Видео Is GraphQL Really "Self-documenting"? | James Scott | API the Docs London 2018 канала API the Docs
Показать
Комментарии отсутствуют
Информация о видео
Другие видео канала
![How Trends in API Documentation Differ from Other TechComm Trends | Tom Johnson | ATD Virtual 2020](https://i.ytimg.com/vi/swktxdNozXU/default.jpg)
![How to add Swagger to Spring Boot - Brain Bytes](https://i.ytimg.com/vi/gduKpLW_vdY/default.jpg)
![3 Things I wish I knew when starting with GraphQL](https://i.ytimg.com/vi/0yr25jzVLMg/default.jpg)
![REST vs GraphQL - What's the best kind of API?](https://i.ytimg.com/vi/PeAOEAmR0D0/default.jpg)
![GraphQL before GraphQL — Dan Schafer @ GraphQLConf 2019](https://i.ytimg.com/vi/gb1R-fWP1Yw/default.jpg)
![Developer Experience as a Product | Ben Ahmady & Tuan-Minh Nguyen | API The Docs Virtual 2020](https://i.ytimg.com/vi/FscA-gsIQgs/default.jpg)
![How to apply best practices of REST APIs to GraphQL](https://i.ytimg.com/vi/yVgZALlVpgo/default.jpg)
![SwaggerHub API Documentation](https://i.ytimg.com/vi/PJVT_EI9i7k/default.jpg)
![GraphQL as an API gateway in microservices architecture - Shipra Gupta](https://i.ytimg.com/vi/8uUMegdI3ZM/default.jpg)
![Introduction To GraphQL](https://i.ytimg.com/vi/anW5Qpuh5kI/default.jpg)
![Documenting GraphQL APIs](https://i.ytimg.com/vi/1Guhxakc0pM/default.jpg)
![How to start a SaaS business in any market with no idea or connections](https://i.ytimg.com/vi/Ee6MlJ1ZRGE/default.jpg)
![Data Analysis and Data Dashboards in Excel : Day-5](https://i.ytimg.com/vi/uYtu2xv_XT4/default.jpg)
![SwaggerHub 101: Learning the Basics](https://i.ytimg.com/vi/epjFQ--Jr4Q/default.jpg)
![Databricks overview and Delta Lake deep dive](https://i.ytimg.com/vi/2wYJ-hc7Fvc/default.jpg)
![Patrick Arminio - GraphQL in Python 🍓](https://i.ytimg.com/vi/38uCu6ZEvfo/default.jpg)
![Intro to API Documentation](https://i.ytimg.com/vi/5pzhtrrtkXY/default.jpg)
![Creating A GraphQL Backend](https://i.ytimg.com/vi/6duKEokTZ44/default.jpg)
![GraphQL Schema Design @ Scale (Marc-André Giroux)](https://i.ytimg.com/vi/pJamhW2xPYw/default.jpg)
![Postgraphile For Beginners Mini Course](https://i.ytimg.com/vi/eDZO8z1qw3k/default.jpg)