Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

35 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2020-04-02 12:21:02 -05:00
---
title: "Resource Oriented Documentation"
date: 2020-04-02T11:34:07-05:00
meta_desc: "Pulumi documentation features a resource-oriented format presented as a single page per resource for easier reading, discovery, and navigation."
2020-04-02 13:26:11 -05:00
meta_image: docs.png
2020-04-02 12:21:02 -05:00
authors:
- luke-hoban
tags:
2021-05-13 12:54:02 -07:00
- features
2020-04-02 12:21:02 -05:00
---
2020-04-02 15:06:10 -05:00
Documentation in any product is super important, and an area where folks have shared a lot of feedback! We've heard you, and this week we took a major step in rolling out a brand new approach to resource documentation. We hope you like it as much as we do.
2020-04-02 12:21:02 -05:00
<!--more-->
## A New Format
2020-04-02 13:26:11 -05:00
2020-04-02 15:06:10 -05:00
In short, our docs are now resource-oriented. Each resource is presented on a single page for better viewing, discovery, and navigation. All content now supports switching between different languages, so that Pythonistas, Gophers, and .NET aficionados can now easily find code examples in their favorite language.
2020-04-02 13:26:11 -05:00
{{< figure src="https://www.pulumi.com/uploads/content/blog/resource-oriented-documentation-blog/newdocs.gif" caption="Pick your favorite language!" >}}
2020-04-02 12:21:02 -05:00
2020-04-02 15:06:10 -05:00
API docs for each language are still available and are deep-linked. In general, we will lead with this resource-oriented format throughout our content as a canonical, language-agnostic reference for all Pulumi resources.
2020-04-02 13:26:11 -05:00
2020-04-02 16:53:10 -05:00
We've rolled this out these for AWS, Azure, and GCP, and other providers, including Kubernetes, will appear soon.
2020-04-02 13:26:11 -05:00
2020-04-02 16:53:10 -05:00
We'd love your feedback on the new docs either in #docs, in GitHub, or via the <i class="fas fa-thumbs-up"></i> | <i class="fas fa-thumbs-down"></i> buttons on the site.
2020-04-02 13:26:11 -05:00
2020-04-02 12:21:02 -05:00
Here are a few pointers:
2020-04-02 13:26:11 -05:00
2023-06-06 17:21:39 -07:00
- An example resource, [SQS](https://www.pulumi.com/registry/packages/aws/api-docs/sqs/queue/)
2023-06-06 06:43:51 -07:00
- [AWS package](https://www.pulumi.com/registry/packages/aws/)
- [Azure package](https://www.pulumi.com/registry/packages/azure/)
- [GCP package](https://www.pulumi.com/registry/packages/gcp/api-docs/)
- [Root API reference](/registry/)