-
Notifications
You must be signed in to change notification settings - Fork 230
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Move Learn Pulumi to Pulumi Tutorials #11883
Conversation
Your site preview for commit ae46b0e is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-ae46b0ee.s3-website.us-west-2.amazonaws.com. |
ae46b0e
to
36c86ad
Compare
Your site preview for commit 36c86ad is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-36c86ad6.s3-website.us-west-2.amazonaws.com. |
36c86ad
to
7c91851
Compare
Your site preview for commit 7c91851 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-7c918519.s3-website.us-west-2.amazonaws.com. |
7c91851
to
6e23961
Compare
Your site preview for commit 6e23961 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-6e239611.s3-website.us-west-2.amazonaws.com. |
6e23961
to
8debc4c
Compare
Your site preview for commit 8debc4c is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-8debc4c0.s3-website.us-west-2.amazonaws.com. |
8debc4c
to
50c3334
Compare
Your site preview for commit 50c3334 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-50c33347.s3-website.us-west-2.amazonaws.com. |
50c3334
to
1baf572
Compare
1baf572
to
c73bf10
Compare
Your site preview for commit c73bf10 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-c73bf107.s3-website.us-west-2.amazonaws.com. |
c73bf10
to
b58e3f7
Compare
Your site preview for commit b58e3f7 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-b58e3f79.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit 9d478ef is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-9d478efa.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit 9d478ef is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-9d478efa.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit 95efd58 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-95efd58e.s3-website.us-west-2.amazonaws.com. |
95efd58
to
ba74840
Compare
Your site preview for commit ba74840 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-ba748405.s3-website.us-west-2.amazonaws.com. |
73c9454
to
c830d44
Compare
Your site preview for commit 73c9454 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-73c94548.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit c830d44 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-c830d44e.s3-website.us-west-2.amazonaws.com. |
c830d44
to
9f3dc49
Compare
9f3dc49
to
f382c96
Compare
Your site preview for commit 9f3dc49 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-9f3dc496.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit f382c96 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-f382c967.s3-website.us-west-2.amazonaws.com. |
f382c96
to
86aefce
Compare
86aefce
to
efbdf2a
Compare
Your site preview for commit 86aefce is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-86aefcef.s3-website.us-west-2.amazonaws.com. |
Your site preview for commit efbdf2a is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-efbdf2a5.s3-website.us-west-2.amazonaws.com. |
efbdf2a
to
b0a3547
Compare
Your site preview for commit b0a3547 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-11883-b0a3547e.s3-website.us-west-2.amazonaws.com. |
This change creates a new section called Pulumi Tutorials (🎉) and bootstraps it with content from Learn Pulumi. As part of this work, I also reviewed (and fixed!) all existing content and redirected all content from
/learn
to its new home at/tutorials
.A few things I've not yet done:
Documented how to create a new tutorial, how tutorials are sorted, grouped, sorted within a group, etc.
Added amake
helper/Hugo archetype to simplify creating a new tutorial. We have these for Learn today and they're nice, but they don't map directly to the new stuff, so they'll need some adjusting.Documented the concept of "collections" as it applies to tutorials. Everything here is a collection, and collections are typed -- so there are "provider" collections (e.g.,
aws
), "proficiency" (i.e., skill-level) collections (pulumi-101
), there'll surely be "product" and "feature" collections soon (ESC, Deployments, Components), etc. Collections are the only grouping mechanism we have, but thetype
field should make this pretty flexible (certainly flexible enough for now), and we can always extend/refactor the content model when/if we outgrow this. Tutorials can also belong to multiple collections, of course, or none, in which case they'll spill into the All Tutorials section on the Tutorials home page.Since there was so little content to go live with here, I created a single collection to start, and called it "Pulumi 101" (feel free to suggest an alternative -- I'm mainly looking for something succinct that conveys that these are meant for new users). It contains the first three Learn modules --- Fundamentals, Building, and Encapsulation, since those are all about core concepts (whereas Automation API and Importing are more advanced topics).
Written up authoring guidelines for tutorials -- what makes a good one, when to use multi-page vs. single-page, a general a structure to follow for both, etc.
Consolidated/figured out what to do with the "cloud engineering glossary". It does feel like there's a place for a glossary of sorts in this new section, so I'll probably find a way to integrate it somehow, but for now, it's got the same treatment it does today (and is redirected to /tutorials/glossary like everything else).
Made all the pre-reqs and intros consistent. I'll be doing that while y'all review what's here.It may also feel like the navigation is a bit "sparse" right now, and that's mainly because we have so little content. As we add more tutorials, collections, and collection types, this will naturally grow and begin got look more like what we've been aiming for.
Fixes https://github.com/pulumi/devrel-team/issues/641
Fixes #12017
Fixes #10226
Fixes #10225
Fixes #12418
Fixes #10619
Fixes #10202
Fixes #10173
Fixes #10163
Fixes #10155
Fixes #11688
Fixes #12423
Fixes #12426