Rocket/site/guide/index.md

2.4 KiB

The Rocket Programming Guide

Welcome to Rocket!

This is the official guide for Rocket v0.5. It is designed to serve as a starting point to writing web applications with Rocket and Rust. The guide is also designed to be a reference for experienced Rocket developers. This guide is conversational in tone. For purely technical documentation with examples, see the API documentation.

The guide is split into several sections, each with a focus on a different aspect of Rocket. The sections are:

  • Introduction: introduces Rocket and its philosophy.
  • Quickstart: presents the minimal steps necessary to run your first Rocket application.
  • Upgrading from v0.4: a migration guide from v0.4 to v0.5.
  • Getting Started: a gentle introduction to getting your first Rocket application running.
  • Overview: describes the core concepts of Rocket.
  • Requests: discusses handling requests: control-flow, parsing, and validating.
  • Responses: discusses generating responses.
  • State: how to manage state in a Rocket application.
  • Fairings: provides an overview of Rocket's structured middleware.
  • Testing: how to unit and integration test a Rocket application.
  • Configuration: how to configure a Rocket application.
  • Pastebin Tutorial: a tutorial creating a pastebin with Rocket.
  • Conclusion: concludes the guide and discusses next steps for learning.
  • FAQ: answers to frequently asked questions about Rocket and using it.

Getting Help

The official community support channels are #rocket:mozilla.org on Matrix and the bridged #rocket IRC channel on Libera.Chat at irc.libera.chat. We recommend joining us on Matrix via Element. If you prefer IRC, you can join via the Kiwi IRC client or a client of your own. The FAQ also provides answers to commonly asked questions.