10 Commits

Author SHA1 Message Date
susan evans
eb6aa357b2
reorg docs nav + add cloud pages (#2769) 2023-05-15 15:25:28 -07:00
Christian Nunciato
3bfe1098ee
Replace relrefs with plain Markdown links (#2071) 2022-10-26 07:22:15 -07:00
Alex Mullans
a754d2c03e
Clean up tags (#215) 2021-05-13 12:54:02 -07:00
Sophia Parafina
55ba12583b Programming model reorganization (#4707)
* Merging existing content with rproposed rewrites in this PR, fixed broken links, etc.

* Add redirect to concepts overview page as stop-gap to handle auto-gened ref content links

* Apply suggestions from code review

Co-authored-by: Luke Hoban <luke@pulumi.com>

* Fix broken links

* Incorporating TR feedback

* Fixed broken links

* Incorporating remaining feedback, renamed and refactored content, updated links

* Add client-side redirect logic to map old anchors to new

* Incorporated more feedback, refactored runtime function content, fixed broken links

* Minor typo fix

Co-authored-by: Christian Nunciato <c@nunciato.org>

* Copy edit

Co-authored-by: Christian Nunciato <c@nunciato.org>

* Update content/docs/intro/concepts/project.md

Co-authored-by: Christian Nunciato <c@nunciato.org>

* Incorporated TR feedback

* Trimmed left nav link title

Co-authored-by: David Wrede <dave@pulumi.com>
Co-authored-by: David Wrede <d_wrede@yahoo.com>
Co-authored-by: Luke Hoban <luke@pulumi.com>
Co-authored-by: Christian Nunciato <c@nunciato.org>
2021-02-03 07:30:42 -08:00
Justin Van Patten
6981f73962 Use relref instead of ref (#2195)
Changes usage of `ref` (fully qualified URL) to `relref` (relative URL), as there's no need for these to be fully qualified and we generally use `relref` throughout.
2019-12-26 13:12:15 -05:00
Zack Chase
5ab3d65926 Add markdown linting (#2135)
* Add markdown linting script; fix markdown lint errors

* Add support for meta description and page title validation

* Add comments

* Fix lint errors; exclude autogenerated tutorials

* Address feedback; add more comments

* Add more checks for redirect pages; no index; and auto generated content

* More fixes for lint errors

* Allow duplicate headings in a page

* More lint error fixes

* Even more lint error fixes

* Getting started guide lint fixes

* Add custom h1 support to docs single pages

* Use custom h1 tags on cloud getting started guides

* Add custom h1 support to docs

* Add custom h1 support to docs lists.html

* Final round of intial lint fixes

* Add markdown linting to build script

* Update README

* Test build failure due to lint error

* Fix lint error so build will pass

* Readability fixes for lint script
2019-12-18 09:59:20 -08:00
Maria Bermudez
5b3e51460b New TOC and breadcrumbs (#1563) 2019-08-23 14:22:47 -07:00
joeduffy
c4438a1e0b Prefer meta_desc over summary
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.
2019-07-30 12:18:23 -04:00
Christian Nunciato
aace0dc79c Replace RELATIVE_TO_PAGE with Page Resource helpers (#1374)
* Replace RELATIVE_TO_PAGE with Hugo Resource helpers
* Remove /images/pulumi.png

Signed-off-by: Christian Nunciato <c@nunciato.org>
2019-07-16 21:31:42 -07:00
Chris Smith
6924d92540 GREAT WEBSITE MIGRATION OF 2018 (#1269)
* Move content into docs/content

* Make navigation and doc generation work

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Make search work

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Move docs-specific layouts into layouts/docs

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Move docs partials into layouts/partials/docs

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Share a common header and footer

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add product & pricing pages, modify main nav

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Bring images under assets, docs images under assets/images/docs

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Link to the docs home page, fix image ref

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add containers, serverless, kubernetes topics

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add careers

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add compete, compete -> migrate

Signed-off-by: Christian Nunciato <c@nunciato.org>

* About, contact

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add legal

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add product

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add partner content

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add webinar

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add why-pulumi

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add GitHub redirect, support

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add blog

* Add blog - update post frontmatter

* Update content/_index.md

Co-Authored-By: Justin Van Patten <jvp@justinvp.com>

* Remove drafts & redundant fonts, move asset dirs up a level

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Reconcile blog navigation

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Migrate some blog content (#1147)

* Reconcile www, blog and docs footer items (#1141)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Clean up blog layout (#1148)

* Migrate more blog posts (#1157)

* Replace Bootstrap with TailwindCSS

* Add Tailwind
* Create a config directory under assets, move PostCSS and Tailwind configs into it
* Remove Bootstrap Sass and JS referemce
* Refactor the header, base template, and footer to use Tailwind
* Pull TOC Sass into its own partial

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor the docs home page

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor docs single, list and section layouts

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor quickstart-clouds partial

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Reposition config items to fix syntax highlighting

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Replace syntax CSS theme with Monokai

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add a dark blue for links

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add the beginnings of Sass color settings

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add a Sass file for langchoose

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Give no-select its own Sass also, since it’s a partial

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Give docs single and list templates more width for main content

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add some padding to the TOC, since we don’t have proper gutters yet

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix button on Quickstart home page

Signed-off-by: Christian Nunciato <c@nunciato.org>

* TOC styles

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Quickstart clouds

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Padding to left and right columns

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Black for TOC

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor docs/aws to use its own layouts

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix the AWS tech partner image

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Adjust AWS layouts

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Move docs-home markup into a layout

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Format the mini-toc

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Reduce subhead sizes a bit

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Remove snowflake styles

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Extract some Sass partials

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Define initial purple and blue palettes, use numbered colors instead

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor blog templates

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Make blog summary a partial, style pagination

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix expanded URLs

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Rename Documentation to Reference

Signed-off-by: Christian Nunciato <c@nunciato.org>

* A smattering of minor adjustments

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Selection state for tags

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Delete more Bootstrap

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Comment the banner

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Restore footer links

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Legal layout

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Remove unused layout

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Refactor careers page

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Use top-level URLs for legal docs

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add RSS for the blog (#1170)

* Add RSS for the blog

* Cleanup team data (#1195)

* Cleanup team data

* Add missing newlines at EOF

* Blog content as of 6/16 (#1196)

* Blog content layout tweaks

* Migrated blog content (as of Sun 6/16)

* Address PR feedback, replace links to pulumi.io

* Add fusion stack

Any changes to the `fusion` branch will now be deployed to https://fusion.pulumi.io/.

* Fix broken links

* Fix broken images in fusion branch (#1207)

Deletes unnecessary uses of `BaseURL`. In a small number of cases, where we want to emit an absolute URL that includes the `BaseURL`, use the `absURL` function instead, which is smart about handling missing/extra slashes.

* Integrate www content (#1208)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Highlight currently selected section tab (#1216)

* Remove unused partials (#1215)

These are no longer referenced, so they can be removed.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Blog content as of 6/24 (#1218)

* Port running-containers-in-aws-the-lowdown-ecs-fargate-and-eks

* Port building-and-publishing-docker-images-to-a-private-amazon-ecr-repository

* Port happy-birthday-to-pulumi-open-source

* Commit updates to package-lock.json

* Link cleanups and other fixes

* Remove 'wip' tag

* Restore meta_* fields, tidy up some frontmatter (#1214)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add search (#1217)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Hide `.language-prologue-*` by default (#1212)

So they all don't initially flash as being visible before all but the selected language are hidden. Port from `_pulumi.scss`.

* Limit team members to those with status “active” (#1219)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix links to datadog provider

* Remove top margin from code snippets under lang tabs (#1223)

* Update MBR DNA logo (#1222)

* Add links to cloud logos (#1221)

And use `logo-aws_white.png` for AWS

* Remove unnecessary aliases (#1210)

Now that we'll be hosting the docs on a new domain, there's no need to
maintain these aliases. The old site hosted at https://pulumi.io will
have redirects from the old aliases to the new location on the new site.

* Pricing page updates (#1224)

* Add swooshes to the home, pricing and webinar pages.
* Replace “tech” PNGs for GitHub, GitLab, Atlassian and SAML with SVGs, and add an email SVG, in order to align all of their images in the pricing grid.
* Add a “See plan details” link above the pricing grid.
* Update Font Awesome to version 5.8.1 (to match what's in use on www today) in order to pull in the infinity icons used in the pricing grid.
* Align CTA buttons horizontally in adjacent boxes containing content of varying heights.
* Fix duplicate links on the home and product pages.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Update API docs (#1227)

* Update tsdocgen paths
* Updated API docs

* Fix broken images (#1228)

Remove unnecessary `{{ .Site.BaseURL }}` prefix from image URLs.

* Fix Hugo build warning about non-relative ref/relref page reference (#1229)

* Fix page titles and errant anchors (#1226)

* Prevent anchors on the home page
* Fix page titles

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add a robots.txt file (#1225)

This change adds a robots.txt template authorizing seach-engine indexing for all pages of the production site.

It assumes that all non-production builds will override the `baseURL` configuration property with something other than `https://pulumi.com/`.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Blog content fixes (#1231)

* Correct post dates, titles

* Revert to previous tags

* Unify tags, adjust for display

* Replace short, social summaries with longer ones

* Use a fixed height for the utility bar (#1232)

When the GitHub widget loads asynchronously and pops into view, it causes the whole page to shift downward a few pixels, because the widget is taller than the links beside it. Applying an explicit hight to the utility bar fixes this.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix TOC expansion for the tour (#1234)

We're very likely going to remove the tour and disperse its content elsewhere, but in the meantime, fix the TOC expansion for "Beyond the Basics" items.

* Add syntax highlighing to layout templates (#1238)

This change adds a partial for highlighting code snippets in layouts.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add home-page video (#1240)

Also makes a few slight adjustments to improve mobile layout on the home page.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Blog layout and styling improvements (#1237)

* Use explicit code blcoks with language

* Fix sort order for Author and Tag listings

* Make sidebar toggleable on mobile

* Resize "poster" image for blog listings

* Crop photos to be square

* Add posted date, post tags to blog footer

* Add recent posts lists to sidebar

* Add syntax highlighting to some missed posts

* Fix Hugo build warning

* Adjust sidebar styling

* Cleanup the /docs page (#1239)

* Cleanup /docs/aws layouts to match other docs sections

* Cleanup /docs pages

- Add left nav
- Make /docs page look slightly less like a "homepage"
- Add top-level "Get Started" and "Reference" headings to left nav

* Add `.btn-secondary` and use it in a few places

* Remove unnecessary cursor setting (#1245)

Should be using the default here. I was debugging and forgot to switch this back before committing.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Update the home page video (#1244)

This is a slightly shorter version, with typing sections sped up slightly to better respect our visitors’ time. 😄

Signed-off-by: Christian Nunciato <c@nunciato.org>

* API doc styling improvements (#1247)

* Update API doc styling for Python

Bring back the styles used for our Python API docs, convert to use Tailwind, and make further tweaks to make it look even better. For example, all definitions now look like code blocks and indentation and spacing is used to improve the hierarchy of the content.

* Only emit the <h1>.Title</h1> if there is a .Title

The generated Python API docs don't currently include front matter and therefore do not have a title. We should fix the Python docs gen to do that, but in the meantime, only emit `<h1>.Title</h1>` if the page has a `.Title`, to avoid an unnecessary gap at the top of the page.

* Update _pygments.scss to select .highlight instead of .chroma

The syntax highlighted code generated by Hugo looks like:

```
<div class="highlight">
    <pre class="chroma">
        <code class="language-foo">
        ...
        </code>
    </pre>
</div>
```

And our styles looks like:

```
.chroma .k { ... }
.chroma .kc { ... }
...
```

This works good, but our generated Python docs, which uses Pygments to do the syntax highlighting, doesn't use `.chroma`, so it doesn't get any syntax highlighting currently, even though all the Pygments classes are there.

This is true for our Node.js docs as well, although, based on how we generate the code for that currently, we could relatively easily update the templates to include a `.chroma` class.

In all cases, the code that we want highlighted will have a `.highlight` class surrounding it, so just update our styles to select `.highlight` instead of `.chroma`.

```
.highlight .k { ... }
.highlight .kc { ... }
...
```

* Update API doc styling for Node.js

* Various mobile adjustments and cleanup (#1250)

* Pull the hero and section nav into Tailwind "components" and apply them.
* Adjust home-page video dimensions accordingly.
* Add mobile x-padding to sections that hadn't gotten it yet.
* Add an anchor exclusion to the head for the About page.
* Fix mobile layout for the Support page.
* Fix centering and item distribution on the About page.
* Additional minor mobile-related adjustments as encountered.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix bug in lang chooser (#1249)

If I've previously viewed a page in our docs with the language tabs,
such as the Get Started guide, and I click the Python tab, that language
choice will be persisted to a cookie.

If I then visit our Node.js API docs, the lang chooser will see the
saved value of "Python" and try to select that tab, hiding all other
language snippets. But our Node.js API docs only contain JavaScript and
TypeScript snippets, so the end result is that all snippets are hidden
and no tab is selected.

This change fixes that. If the value in the cookie does not exist in any
of the tabs on the page, fallback to the default (JavaScript), otherwise
fallback to the first tab that is available on the page.

* More small fixes (#1254)

* Make the header more responsive

Adds padding to medium and above, and adjusts font size and spacing at medium width in order to accommodate the number of items we’re displaying currently. Also uses the full Pulumi logo, since we have room for that now, and adds a little color to the hamburger.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Bottom-align the image on the whitepaper layout

Also removes the `header` selector from `_hero.scss` in order to reduce the specificity of the rule, allowing it to be overidden more easily with other Tailwind classnames.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add team@pulumi link to the footer

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Restore the newsroom and investors sections

Somehow these got dropped! 😱

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Add hero background glows (#1257)

Also deletes unused templates.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Hide scrollbars if not needed (#1256)

* Improve Pricing page responsiveness, fix a few other small things  (#1259)

* Fix section link on the Why Pulumi page

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Capitalize Kubernetes in copy

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Adjust image sizes on Whitepaper page

Properly size them on both mobile and desktop.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Fix paging on mobile

Decrease padding to prevent overflow.

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Improve Pricing page layout

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Replace home page video with carousel (#1260)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Change Segment module to WWW (#1265)

* Hook up new www.pulumi.com/staging stack to CI/CD (#1262)

* Move older 'pulumi.io' stacks to infrastructure-old

* Add new 'www.pulumi.com' infrastructure folder

* Scripts to hook up to CI/CD

* Switch back to using generic Travis worker

* Add alias to CDN for staging.pulumi.io

* Remove alias to staging.pulumi.io

* Do not use named profiles for deployments

There's an issue today where named profiles which use
`credential_source=Environment` don't actually behave correctly with
the assume-role tool. Instead of actually assuming the role, it just
uses the credentials in the environment, which is not exactly what you
want.

For now, explicitly set the ARN we want to assume, instead of
indirecting across a named profile.

* Remove CloudFront alias entirely

* Add hover menu (#1266)

Signed-off-by: Christian Nunciato <c@nunciato.org>

* Hook up new www.pulumi.com/production stack to CI/CD (#1267)

* Hook up new www.pulumi.com/production stack to CI/CD

* Correct Makefile syntax

* Migrate blog posts as of 7/2 (#1268)

* Fix Makefile syntax

* Fix spelling error ::sigh::
2019-07-02 16:30:33 -07:00