GREAT WEBSITE MIGRATION OF 2019

[justinvp]

Rollup of remaining tasks to rollout the combined site. We'll of course have some additional follow-up work afterwards to further deduplicate content, improve the structure & information architecture, etc.

Website Merge

P1

• [cnunciato] Create robots.txt
• [cnunciato] Restore meta_* items that were deleted
• [cnunciato] Docs: Search form and results styling
• [cnunciato] Review pricing page (Chris has some feedback)
• [justinvp] Another pulumi/docs branch integration from master => fusion (changes since 6/17) (Merge branch 'master' into 'fusion' #1220)
• [justinvp] Improve /docs page (no longer needs to look like a website “homepage”; add Pulumi intro and diagrams) (Cleanup the /docs page #1239)
• [justinvp] Regenerate all API docs (Update API docs #1227)
• [justinvp] Remove aliases (Remove unnecessary aliases #1210)
• [justinvp] Update CLI gen-markdown command for new site (Update gen-markdown command for new site pulumi#2869)
• [chrsmith] Add latest blog posts (changes since 6/16) (Blog content as of 6/24 #1218)
• [chrsmith] Add latest blog posts (changes since 7/1)

P2

• [cnunciato] Add the "hover menu" for top-level nav items (quick links into the section)
• [cnunciato] Code samples aren’t getting syntax highlighting in www content
• [cnunciato] Mobile experience review / tweaks
• [justinvp] Port change to hide language prologue classes by default (Hide .language-prologue-* by default #1212)
• [justinvp] Nav bar should show which section is active (Highlight currently selected section tab #1216)

P3

• [cnunciato] Some heroes still need their background gradients/glows
• [cnunciato] a few places still need those purple-and-gray waves
• [cnunciato] Some color combinations still aren’t quite right

P4

• [justinvp, Post-migration website tweaks #1325] Fix styles used on AWS Crosswalk images to use Tailwind
• [justinvp, Post-migration website tweaks #1325] Looks like we have both /image/pulumi.png and /social/pulumi.png used as meta images. We should standardize on /image/pulumi.png and update any redirects as appropriate.
• [cnunciato, Website tweaks #1277] We seem to be generating an rss.xml file for all sections; is there a way to make it only generate for /blog/rss.xml?

Rollout

• [justinvp] Deploy redirects for https://pulumi.io and https://blog.pulumi.com to https://www.pulumi.com (adopting existing stack resources as needed) (using https://github.com/pulumi/home/pull/507)
• [chrsmith] Rollout (infrastructure changes, branch changes, etc.)

Post-Rollout

• [justinvp] Deploy change to service to request https://www.pulumi.com/latest-version (avoid unnecessary redirect hop) (https://github.com/pulumi/pulumi-service/pull/3673)
• [justinvp] Merge change to installer script to request https://www.pulumi.com/latest-version (avoid unnecessary redirect hop) (Get the latest CLI version from www.pulumi.com get.pulumi.com#43)
• [justinvp, Post-migration website tweaks #1325] Hook up Purgecss to remove unused CSS classes (Use Purgecss to reduce the size of our CSS #1291)
• [praneetloke] Deploy change to pulumi/pulumi-az-pipelines-task to request https://www.pulumi.com/latest-version (Use the new endpoint for fetching the latest Pulumi CLI version. pulumi-az-pipelines-task#18)
• [justinvp, ToC & Information Architecture #831] Consider moving /docs/quickstart/ to the root, e.g. /get-started (and decide where we want tutorials to live long term)
• [chrsmith, Replace all references of pulumi.io to www.pulumi.com #1311] Strip https://pulumi.io/ prefix from any remaining links (looks like these are actually in our API reference docs; we can fix these up post-rollout)

[lukehoban]

• [cnunciato] The whole page "shakes" a bit when navigating between pages - particularly the top nav (which seems to slightly vertically resize during navigation, leading to relayout of everything else on page).

[praneetloke]

• [P1, cnunciato] Carousel on the landing page seems to be missing. I couldn't find a corresponding issue in the main issue description above.

This was on FF (latest version). It's the same on Chrome too.

• [Post-launch, cnunciato, Improve visibility of "Community Edition" on pricing page #1287] This is not an issue with the migration itself but I think the Community Edition (on the Pricing page) note is sort of easy to overlook as the cards and the tables are the main focus of that page. Also, it would be nice to do something like https://visualstudio.microsoft.com/vs/compare/ or even have a dedicated community edition page like MySQL: https://www.mysql.com/products/community/ to explain what you get/don't get in the CE. Right now it is unclear what features are, more importantly, missing in the CE.

[justinvp]

• Do we want to keep the "Announcing Pulumi Crosswalk for AWS" banner on the new site for now? Decision: We will not show the banner in the new site, unless we hear otherwise.

[lukehoban]

• [chrsmith] Many blog posts have wrong date or title? (wrong date: blog/program-the-cloud-with-12-pulumi-pearls/, wrong title: blog/introducing-pulumi-crosswalk-for-aws-the-easiest-way-to-aws/)
• [chrsmith] Blog summaries on /blog/ are missing large parts of the "intro paragraphs" -and instead have giant hero images - makes it hard to get a feel for what content is there. Relatedly, size of titles relative to other content on the page feels too small.
• [chrsmith] Blog missing any "related posts" or "recent posts" sidebar - hard to get a feel for what otehr content is available when you are on a post
• [chrsmith] Blog tags feel "strange" - like super granular, and unclear what they mean (aws/lambda/fargate?). Significantly preferred simplicity+clarity of old tags ("AWS", "Serverless", "Kubernetes", "Infrastructure"). Also, was nice that these had counts on them previously so you could quickly get a feel for what kind of other content was available related to topics of interest.
• [chrsmith] Blog code blocks have awkward "scroll bars?" even when there is not content to scroll?
• [chrsmith] Syntax highlighting seems to be missing from at least some posts (https://fusion.pulumi.io/blog/running-containers-in-aws-the-lowdown-ecs-fargate-and-eks/)
• [cnunciatio, Website tweaks #1277] h6 seems to be formatter as ALLCAPS, even when styling an inner code element? (see https://fusion.pulumi.io/docs/reference/programming-model/#dependson).
• [justinvp] API docs generally feel worse: (1) missing syntax highlighting (2) missing visually recognizable hyperlnking (3) less visual distinction between different classes (4) Overall formatting of the Index+Module section (API doc styling improvements #1247)
• [justinvp] Python API docs have giant ¶ characters for anchor links. (API doc styling improvements #1247)
• [justinvp] Python API docs feel disorienting - the tables are an improvement, but they drown out the titles of the actual APIs that are being documented. This wasn't great previously, but feels even harder to read now. (API doc styling improvements #1247)

[joeduffy]

I'll just keep adding to this over the next 24 hours. Feel free to slurp up any as you see them.

• [cnunciato] Both "TRY PULUMI" and "READ THE DOCS" on the homepage go to the same place -- mistake?
• [justinvp] Currently selected section tab (e.g. "PRICING") isn't highlighted when navigating to it (Highlight currently selected section tab #1216)
• [cnunciato] We are missing the "swoosh" in a number of places (e.g., half way down PRICING page)
• [cnunciato] Missing "See plan details ->" link on pricing page
• [cnunciato] Some sections aren't center aligned anymore (e.g., "Plan details" blurb on the pricing page)
• [cnunciato] "Basic secrets management" missing on TEAM STARTER column -- and as a result, the buttons are misaligned between the editions
• [cnunciato] Buttons on the pricing editions are the wrong colors (blue/purple/green)
• [cnunciato] In general, the blue buttons are the wrong color of blue -- they should be "action blue"
• [cnunciato] Missing the infinity symbol on the "unlimited" items in the pricing editions
• [cnunciato] Missing "team@pulumi.com" email link on the footer
• [justinvp] Cloud logos on homepage aren't hyperlinked (Add links to cloud logos #1221)
• [chrsmith] The preview text for the blog entries doesn't seem right -- it's using our social media summary which tends to be extremely terse -- let's go back to what HubSpot did here
• [chrsmith] As Luke notes, the blog tags are super strange -- let's please keep old tags until we have an intentional effort (post launch!) to redesign them
• [chrsmith] We intentionally don't list blog dates on them, to keep them more timeless, let's please remove
• [chrsmith] On mobile, blog tags take up a lot of vertical real estate, including on blog posts themselves -- maybe just show on the homepage, and maybe put in a drop-down?
• [chrsmith] The preview images are too large, let's keep it similar to our old format of having them right aligned and smaller
• [chrsmith] I didn't see where the blog article lists its tags; this used to be at the bottom (see "Topics: x, y, z").
• [cnunciato] The code boxes seem to have lost their fake Mac toolbar, plus all styling
• [cnunciato] The ABOUT link at the top is missing [wontfix: it's in the footer and needn't be at top level anymore]
• [cnunciato] The ABOUT page seems to be formatted strangely
• [cnunciato] The ABOUT page lists a lot of people on our team that aren't on our team ...
• [cnunciato] At /aws, our partner image is stretched
• [cnunciato] The /aws page has a lot of formatting issues
• [cnunciato] The same is true of /azure, /gcp, /kubernetes, and /terraform
• [P1, justinvp] Broken images on above /aws, /azure, /gcp, /kubernetes, and /terraform pages (Fix broken images #1228)
• [P1, justinvp] The "LEARN" button on the docs homepage seems to have changed to "REFERENCE" -- which is not a verb and thus doesn't drive you to take action (intentional design with the old text) (Cleanup the /docs page #1239)
• [cnunciato, Website tweaks #1277] The highlighting of currently selected section in the nav is barely noticeable
• [P1, justinvp] On the docs landing page, the gray band with logos, and also the one lower with containers, etc, is not centered correctly (Cleanup the /docs page #1239)
• [P1, justinvp] UX feedback: it's very jarring that there's no left nav when you click on the DOCS navigation; I realize this isn't new per se, but something about the new flow makes this feel really disorienting to me (probably due to the lack of a REFERENCE TAB now) -- let's fix this first as we reconcile the duplicate homepages (Cleanup the /docs page #1239)
• [cnunciato] Search seems to have gone missing?