Laracon DB
Laracon DB
Talks for "documentation"
Lumen, Guzzle, & Swagger

The talk focuses on building and documenting APIs using Laravel/Lumen, with a particular emphasis on using Swagger/OpenAPI for API documentation and bridging the gap between client and server sides. The speaker discusses various tools and best practices for API development, including authentication methods, content negotiation, and code generation from Swagger documentation. The presentation concludes with a musical number encouraging developers to use Swagger for better API development.

APIs With Laravel

TJ Miller presents a comprehensive talk on building and maintaining Laravel APIs, covering best practices from planning through implementation. He emphasizes the importance of documentation, resource responses, schema validation, and maintaining API contracts while sharing practical workflows and implementation patterns developed over years of experience building critical payment processing APIs.

The Curse of Knowledge

A talk about the 'curse of knowledge' in software development and technical communication. The speaker discusses how experienced developers often assume others have the same level of understanding, leading to poor documentation and unhelpful responses to questions. She emphasizes the importance of being kind and clear when helping beginners, avoiding technical jargon, and acknowledging that learning to code is difficult.

Design at Laravel

David Hill, head of design at Laravel, discusses the importance of design beyond aesthetics, emphasizing problem-solving and attention to detail. He announces three upcoming projects: a Laravel brand site for resources and templates, a refresh of Laravel.com, and improvements to Laravel documentation with community input.

Bringing User Stories to Life

The speaker shares their experience developing a new approach to user stories at Allegro Networks, a networking company. They describe how they evolved from traditional user story formats to using comics and visual storytelling to make requirements more engaging and understandable. The approach helped communicate complex technical concepts to non-technical stakeholders and improved engagement with project documentation.

Building your API with Apiary & Dredd

The speaker discusses moving from traditional API testing in Laravel to using API Blueprint specifications. He demonstrates how API Blueprint provides a language-agnostic way to define API structures using markdown, which can be tested using Dredd. The talk covers practical examples of implementing API specifications, using hooks for authentication, and organizing large APIs by splitting specifications into multiple files using Hercule.

Building APIs with Laravel using OpenAPI

Chris Tankersley presents on using OpenAPI to document and build APIs in Laravel. He explains how OpenAPI serves as a specification format for HTTP APIs, demonstrates tools like Stoplight Studio for API design, and shows how to generate Laravel boilerplate code from OpenAPI specs. The talk focuses on practical implementation using a to-do app example while highlighting the benefits of consistent API documentation and development.

Documenting Laravel APIs

James Brooks presents a talk on documenting Laravel APIs using Scribe, demonstrating how to automatically generate comprehensive API documentation directly from code annotations and comments. He shows how to group endpoints, add request/response examples, handle authentication documentation, and discusses hosting options including using bump.sh for enhanced documentation features.