* 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>
* Move filter and CTA to right side of event listing page
* Add heading to event list showing number of events available when filtering
* Remove calendar embed and use button to bring up calendar modal
* Slightly prettify the event-listings page
* Slightly prettify the event-detail page
* Make the registration button orange
* Add ability to use filter query param to pre filter events
* Address feedback
* Remove excess console.log
* Update assets/js/event-filtering.js
Co-Authored-By: Justin Van Patten <jvp@justinvp.com>
Co-authored-by: Christian Nunciato <christian@pulumi.com>
Co-authored-by: Justin Van Patten <jvp@justinvp.com>
* Initial implementation of documentation feedback
* Fix typo
* Cleanup formatting and mobile layout
* Add tracking attributes to feedback buttons; use beforeunload event
* Address feedback
* Move feedback section to right nav; convert comment section to modal
* Mobile adjustments
* Make it play nicer visually with others
* Update modal text and add close button
* Fix typo
Co-Authored-By: Justin Van Patten <jvp@justinvp.com>
* Address feedback
* Revert back to using production segment key with environment control
Co-authored-by: Christian Nunciato <christian@pulumi.com>
Co-authored-by: Justin Van Patten <jvp@justinvp.com>
* Add initial framework for event landing page
* Clean up event one pager and add new CTA
* Replace image with code block; update cta copy
* Update desktop cta and deploy block copy
* Update address to have google maps link
* Remove unused block and content
* Update naming convention for blocking crawlers from indexing a page
* Rename variable for excluding page from internal search
* Do not add pages blocked from external search to the site map
* Add follow to robots meta tag
* Update contributing doc with new front matter variable
* Remove external search blocking from docs index
* Rename event to show
* Move meta desc so pulumify can rebuild the preview
* Add link linter script
* Add build commands for linting links
* Add linting to start of serve script
* Add tracking ids to links
* Add tracking id to links
* Finish adding tracking ids to remaining html links
* Add front labels to lint results
* Add some checks to function inputs; address feedback
* Add checks that the element exists before sending tracking event
* Add urlize to dynamically created tracking ids
* Switch to generating ids instead of hardcoding
* Do not encode strings when generating link tracking ids
* Convert to use data-track attribute instead of data-tracking-id
* Remove link linter
* Fix duplicate read more tag
* Revert breadcrumb html to be one line to eliminate extra space
* Remove unused package
* Update g suite name convention on tracking id
Co-Authored-By: Christian Nunciato <c@nunciato.org>
Co-authored-by: Christian Nunciato <christian@pulumi.com>
This changes the structure of the nav slightly: instead of showing
"Overview" pages for each sub-section as an independent entry, which
consumes vertical space, hyperlink the section header itself. This
feels more intuitive to me, matches the way the breadcrumbs work,
and saves us on a bit of vertical real estate (which is getting fairly
scarce on our site now-a-days, as we continue to add more sections).
* Don't block on anchor.js
* Add “| Pulumi” to page titles
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Honor shortened title tags where present
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Fix link to example tutorial
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Add H1 tags to pages without them
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Reduce image sizes
Signed-off-by: Christian Nunciato <c@nunciato.org>
* Restyle pricing form and create template for form with quote
* Address feedback
* Use faded blue input focus highlight; blue submit button
* Make customer quote optional in form-section
* Use new form styles across all hubspot contact us forms
* Add form id to about content; fix id of gcp form section
* Getting Started background color; quote heading text size
* Minor tweaks
Signed-off-by: Christian Nunciato <c@nunciato.org>
- Fix left alignment of "Edit on this Page" and "Request a Change"
- Remove "Edit on this Page" for generated pages
- Add "WARNING: this was generated by a tool" comment to generated pages
- Use Tailwind for styles
* Generalize `toc_nochildren` instead of looking for specific names
* Expandable/collapsable second level toc items
And cleanup the implementation while making changes here.
* Make CI/CD & SAML sub-pages true nav items
Now that we support expandable/collapsable second level nav items in the TOC, make the CI/CD and SAML sub pages true nav items, to match the nav items in Crosswalk.
* 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
This change adds an OS chooser similar to what we have for languages.
This is then used for various installation pages to offer the end user
the ability to choose something other than the default that we've
detected -- in addition to making that choice sticky using cookies.
Most of the same code for the language chooser is refactored and
reused, although some of it had to remain specific to languages due
to the special case of hiding/showing code blocks.
Fixes#1394.
* Move CI/CD docs under console/continuous-delivery
* Rename CI/CD docs
* Update references to new page locations
* Add CI/CD items to left-nav
* Migrate rest of Service docs
* Update a few more broken links
* Address PR feedback
This change prefers meta_desc over summary for controlling meta
description tags.
It also undoes the check for a missing meta description in the
prior commit. Since we unconditionally use Hugo's auto content
summarization via .Summary, it doesn't do anything meaningful.
We may want to revisit this as part of pulumi/docs#1475.
This change fixes up some titles and meta descriptions, in hopes
that it'll have a positive impact on our SEO (and SERP summary).
- Ensure all pages have titles and meaningful meta descriptions.
- Error out if pages lack a meta description. Also add the ability
to write `nosummary: true` if it's intentionally omitted.
- I'd like to error out if pages lack a title too. Unfortunately,
the Python API docs are missing titles (pulumi/docs#1127), so this
check is not currently enabled (easy to uncomment out later).
I also made the possibly-controversial change to stop emitting an
automatic `- Pulumi` at the end of page titles. This
- Leads to illy things -- like `About Pulumi - Pulumi`.
- Might make it more difficult for Google to extract a good title for
our SERP summary; is that why "Documentation" is currently
awkwardly labeled simply "Pulumi" on Google at the moment?
- Probably has a net negative effect on things like blog articles,
which we would like to index naturally based on the content.
I propose that anywhere we want Pulumi in the title, we manually add it.
