* Rearrange existing User Guide ToC
* Rename "Tutorials and Guides" to "User Guides."
* Rename "Cloud Programming Tutorials" just to "Tutorials."
* Sort "Tutorials" at the top of this list.
* Make room for the new "Adopting Pulumi" user guide.
* Add the Adopting Pulumi index page
* Add an import guide
This is largely based on the existing import blog post.
* Add an initial, half completed, Terraform guide
* Add the empty AWS, Azure, and Kubernetes pages
* Fix a few broken links
* Add coverage of tf2pulumi in the adoption guide
* Use shorter titles
I had wanted to use the longer titles because they look better in
SEO. However, unfortunately the breadcrumbs use the title it seems,
and not the display H1 or menu name, which means the breadcrumbs
ended up looking ridiculously long and redundant.
* Add an AWS CloudFormation migration guide
* Add a guide for moving to Pulumi from ARM
* Add some logos to spruce things up
* Add a page for Kubernetes adoption
* Fix a typo in the copy button code
* Apply @lukehoban suggestions from code review
Co-Authored-By: Luke Hoban <luke@pulumi.com>
* Incorporate more code review feedback
Co-authored-by: Luke Hoban <luke@pulumi.com>
* Do an editorial pass over programming model docs
This is an editorial pass over the programming model docs, as part
of #1618. This includes rearranging ordering to minimize forward
references, getting rid of anything that smells "TypeScript-only",
restructuring headers so the ToC is a bit more structured,
wordsmithing, fleshing out examples, and trying to simplify the
presentation of content -- while also embellishing where it helps.
This is not done. The Go and TypeScript pages are empty. There is
still quite a number of TypeScript-only hyperlinks and terminology.
* Add Vim swp files to gitignore
* Use shortcodes to cut down on language-specific text/links
This change adds some shortcodes for common language-specific
text and associated links.
For instance, outputs are Output in JS, Output<T> in TS,
Output[T] in Python, Output in Go, and Output<T> in C#, and go
to very different places hyperlink-wise.
Because of the way our language switcher JavaScript works, we
display the JS version by default until it kicks in and picks
up the user's choice. This avoids awkward flashes in which all
or none of the options are available or missing.
I'm not done applying this to all possible codes, but at least
it lays the foundation to start paying down this debt.
* Fix a couple hygiene issues
* Clarify conditional execution of apply
* Fix input shortcode
* Add shortcodes for most language-specific things
This eliminates most (all?) of the language-specific texts and
links in the programming model document, replaced with shortcodes.
* Fix up some loose ends
* Add Go language page and Get Started guides
* Fix linter errors
* Apply suggestions from code review
Co-Authored-By: Christian Nunciato <c@nunciato.org>
* Apply additional code review feedback
* Use spaces, not tabs.
* Use tailwind styles, not inline CSS.
Co-authored-by: Christian Nunciato <christian@pulumi.com>
This change adds a few things to the .NET landing page:
- Add the .NET Core logo.
- A bit more about "why you might care."
- Add a basic code snippet.
- Add a Getting Started section. We want to drive people here
when first landing on this page as much as possible, since it's
the best experience (despite it being C#-only).
- Use the language switcher for C#/F#/VB templates.
- Reorder some content so most relevant is above the fold.
- Add CI/CD coverage of Azure DevOps pipelines and GitHub Actions.
* New Home Page
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Edit bits of the new homepage (#1665)
* Edit bits of the new homepage
This is a work in progress, however makes the following changes:
* Use a different heading/subheading.
* Make some fonts larger.
* Move the CTA above the fold and make it more prominent.
* Move Create/Deploy/Manage above the widget and style it differently.
* Change the text within Create/Deploy/Manage cards, and use
a bulleted headings style for the major points.
* Add a SVG header to the Manage card for symmetry -- although
it needs to be revised to include e.g. identity providers.
* Add real quotes.
* Add some new logos.
* Reorganize some non-homepage things
* Make the top navbar sticky -- and remove stickiness from some
of the other second level navbars that are less important now.
* Use bg-purple-900 rather than black in some places. The black
contrast just looks really retro and tacky to my eyes. (Honestly,
still could use some work here, but it's marginally less horrific.)
* Eliminate PRICING from the top nav. Our belief is too many people
click this and think we're 100% commercial without having open
source offerings. This page is still available, but is more deeply
integrated with the PRODUCT flow.
* Overhaul the PRODUCT page:
- Better top level messaging.
- Reuse the new carousel widget rather than the aging code snippet.
- Revamp all of the details below.
- Use slightly more modern looking FA icons rather than
the images we had before (which looked kind of random).
- Remove "Multi-Cloud Subscription" -- and add
"Support and Training."
- Link out to the PRICING page in certain key areas.
* Revamp overall message on the CAREERS page and massage some
margins and font sizes.
* Move WHY-PULUMI further to the right of the nav bar.
Sights set on revamping WHY-PULUMI next ...
* Revamp the Why, Pulumi page
* Remove some unused bits
* Tidy up partner, migrate, and topics pages
The partner, migrate, and topics pages are showing their age. At
some point (soon) we need to just blow them up and rewrite them with
our current voice and perspective. For the time being, I do know
they are helping with SEO, so I've done a pass over them to bring
them (roughly) up to code -- still not perfect, but much better.
* Rework titles and abstracts for all pages.
* Replace @pulumi/cloud* examples with modern equivalents.
* Direct to the general GET STARTED page in most places.
* Rewrite the how-pulumi-works partial to use HTML and our more
recent language and logos, instead of an aging screenshot.
* Ensure consistency on black 2nd level nav bars.
* Add partner logos for Azure and GCP.
* Use a real YouTube embed for the link to our video.
Fixes#1588.
* Refine the Why, Pulumi page further
* Make some more edits
...primarily to the "migrate" pages.
* Incorporate latest changes
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Make final edits (#1683)
* Update the top level phrasing.
* Capitalize "Modern Infrastructure as Code" (it's bolder/stronger).
* Tweak some minor other language.
* Add a link to the video.
* Change carousel nav, tweak video, comment alert
* Make some adjustments for narrow mobiles
* Normalize several cloud-vendor SVGs (these are now stored in Figma as well)
* Add an OpenStack SVG
* Use these logos on the docs home, get-started home, and supported-clouds pages
* Add a hover effect to the logos, to indicate interactivity
* Adjust the border and hover colors on the get-started page, to match those on the home page
* Remove unused PNGs
* Remove an unused partial
Signed-off-by: Christian Nunciato <c@nunciato.org>
