276 Commits

Author SHA1 Message Date
Joe Duffy
533941aa46 Add an Adopting Pulumi user guide (#2484)
* 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>
2020-03-08 20:58:38 -07:00
Joe Duffy
3a03f3306a Support shell line continuations in copy button (#2606) 2020-03-08 15:44:16 -07:00
Sophia Parafina
b244acb50e fix #1764 (#2184)
Updated python sections for Getting Started
2020-03-04 07:01:39 -08:00
Christian Nunciato
a1deafb3f5 Allow for wider docs layouts for screens that can use it (#2552)
Signed-off-by: Christian Nunciato <c@nunciato.org>
2020-02-27 12:50:10 -08:00
Christian Nunciato
d92d3e24b8 Only run autoprefixer, cssnano and purgecss for production builds (#2494) 2020-02-20 15:34:18 -08:00
Christian Nunciato
356f517d18 Set tab-size to four spaces for code sampes (#2495) 2020-02-20 14:47:20 -08:00
Zack Chase
f19a9c1c79 Add target selector to purgecss whitelist (#2489) 2020-02-20 10:08:27 -08:00
Justin Van Patten
4618d04da4 Tweak PurgeCSS to include some missing CSS selectors (#2485)
I noticed the CSS for styling a data source "symbol" was missing in the `@pulumi/aws` NodeJS API docs. The reason it's missing is because we only look or classes in the `@pulumi/pulumi` package, and that package doesn't have any datasources. To fix, just swap looking at `@pulumi/aws` rather than `@pulumi/pulumi`.
2020-02-19 21:13:08 -08:00
Christian Nunciato
1b7d1aa7d4 Hide scroll gutters when they aren't necessary (#2463) 2020-02-18 16:38:21 -08:00
Zack Chase
a10d507193 Add PurgeCSS to remove unused CSS classes from page loads (#2444)
* Add purgecss to postcss config

* Update purgecss rules

* Address feedback

* Update extractor regex and content paths

* Update comments in config file
2020-02-18 15:43:27 -08:00
Zack Chase
af877a3610 UX improvements to events pages (#2419)
* 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>
2020-02-13 11:38:39 -08:00
Justin Van Patten
1a68f32070 Add copy & noselect support for bat & powershell (#2411)
Updates the copy button and noselect scripts for bat and powershell.
2020-02-08 05:45:30 -08:00
Christian Nunciato
25bd312525 Add a Brand page (#2394)
* Add a Brand page

* Address feedback
2020-02-06 17:44:34 -08:00
Zack Chase
d43b972ce6 Add events pages (#2318)
* Add initial framework of events listing page

* Add prototype of event generation and landing pages

* Start moving event generation code to go project

* Add functions for building event pages in go

* Generate event specific pages by content type value

* Update event page generation, page content, and styles

* Formatting fixes

* Address feedback

* Add meta_desc to event pages and fix markdown lint errors

* Reorder events by date; remove unused package

* Move calendar above details on mobile

* Use archetypes for generating event pages

* Remove event generation tool

* Add registration heading above calendar

* Remove references to toml parsing libraries

* Add container to event listings and landing pages

* Rename layouts

* Update assets/js/event-filtering.js

Co-Authored-By: Christian Nunciato <c@nunciato.org>

* Update archetypes/workshop/index.md

Co-Authored-By: Christian Nunciato <c@nunciato.org>

Co-authored-by: Christian Nunciato <christian@pulumi.com>
2020-02-06 16:58:30 -08:00
Zack Chase
7e0b7cb8df Fix typo on unload listener (#2389) 2020-02-06 11:20:44 -08:00
Christian Nunciato
844c573656 Make the docs sidebar sticky (#2377) 2020-02-05 15:58:53 -08:00
Zack Chase
ec56439939 Add a way for users to provide feedback on a docs page. (#2284)
* 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>
2020-01-24 14:28:24 -08:00
Justin Van Patten
2c22269fbe Revert "Unconditionally choose selections (#2279)"
This reverts commit 28dc99ae6a883fb17a68ea7149f39f18060941d9.
2020-01-22 10:13:40 -08:00
Joe Duffy
28dc99ae6a Unconditionally choose selections (#2279)
If a language has been chosen, unconditionally select it. This
ensures that, even in cases where there are no tabs, we will honor
the choice and hide/show divs/spans on the page.
2020-01-22 08:31:14 -08:00
Joe Duffy
911188968d Do an editorial pass over programming model docs (#2241)
* 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>
2020-01-21 19:34:59 -08:00
Zack Chase
ef3af6e179 Add fallback incase link does not have an href (#2250) 2020-01-15 14:31:30 -08:00
Zack Chase
3e054d0ea3 Add event tracking to link clicks (#2199)
* 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>
2020-01-15 12:51:13 -08:00
Joe Duffy
49f758c0ee Integrate "overview" pages with the nav (#2214)
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).
2020-01-05 11:18:59 -08:00
Christian Nunciato
3da3ad1c6d Adjust tags styling for consistency (#2112)
Signed-off-by: Christian Nunciato <c@nunciato.org>
2019-12-11 10:45:38 -08:00
Christian Nunciato
7257ebd459 Allow for restricting max-height on code blocks (#2055)
Signed-off-by: Christian Nunciato <c@nunciato.org>
2019-11-27 11:27:34 -08:00
Zack Chase
cdce95b1e5 Add link tracking script and apply it home page links (#2034) 2019-11-26 10:49:11 -08:00
Christian Nunciato
d73456f6d8 Support tab selection by query param (#2044)
Signed-off-by: Christian Nunciato <c@nunciato.org>
2019-11-25 15:00:21 -08:00
Zack Chase
e4ef78d6eb Restyle pricing form and create template for form with quote (#2017)
* 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>
2019-11-21 14:33:47 -08:00
Christian Nunciato
3f7a9e3d8d Handle reflows triggered by the language chooser (#1976) 2019-11-13 21:08:57 -08:00
Mike Metral
a514eccfda scss: fix typos for k8s-language 2019-11-13 11:38:32 -08:00
Mike Metral
6c828a9f6c sass: add cursor pointer for k8s-language-tab 2019-11-13 11:38:32 -08:00
Justin Van Patten
d3974c00c2 Use a pointer for cloud chooser tabs. 2019-11-13 11:38:32 -08:00
Mike Metral
4768c79179 styling: make TS default k8s-language choice 2019-11-13 11:38:32 -08:00
Mike Metral
cbc57678f9 Add k8s-language chooser shortcode 2019-11-13 11:38:32 -08:00
Mike Metral
905fd33c72 Add cloud chooser shortcode 2019-11-13 11:38:32 -08:00
Justin Van Patten
b5e1bff3d4 Minor tweaks to the .NET page (#1953)
* Minor tweaks to the .NET page

* Avoid jumping scroll position on Safari

Add F# and VB examples at the top to mitigate. The scroll position still jumps slightly due to each language's example having differing number of lines, but at least the scroll position remains in the vicinity of where it was before.

* Fix Getting Started buttons on mobile

* "VB" instead of "Visual Basic" in lang chooser tabs
2019-11-09 20:55:19 +00:00
spara
28f35e0f9e updates 2019-11-04 10:38:48 -06:00
Christian Nunciato
eeda11e914 Tidy up the 404 page (#1917) 2019-11-01 11:35:26 -07:00
Justin Van Patten
7358522293 Add fsharp and visualbasic 2019-10-31 15:53:37 -07:00
Justin Van Patten
cfd8d8f55f Lang chooser support for .NET/C# 2019-10-31 15:53:36 -07:00
Cyrus Najmabadi
cefdbb434a Initial 2019-10-31 13:30:13 -07:00
Praneet Loke
4305eb5f3a Add docs for self-hosting Pulumi for Enterprise Edition customers (#1894) 2019-10-31 10:40:56 -07:00
Justin Van Patten
9ffdf767bd Don't filter deprecated APIs in Node.js docs (#1779)
- Instead, keep them with a "deprecated" note.
- Regenerate the docs (including updated docs for `@pulumi/kubernetes` v1.1.0 which has new deprecations.
2019-09-25 10:54:22 -07:00
Christian Nunciato
6729e314eb Only offset anchors at medium and up (#1772) 2019-09-21 10:34:34 -07:00
Christian Nunciato
a066e0aec4 Add a vertical offset to anchor links (#1771) 2019-09-20 20:57:07 -07:00
Christian Nunciato
29428ed392 Fix HubSpot form styling (#1760)
This change applies explicit an explicit font color for form fields, rather than allowing it to be inherited.
2019-09-18 13:17:57 -07:00
Justin Van Patten
a5c3c28212 Expandable/collapsable second level TOC items (#1723)
* 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.
2019-09-11 15:55:11 -07:00
Maria Bermudez
d058a12e45 A very crude implementation of the glossary (#1547)
* A very crude implementation of the glossary
No real styling has been applied yet, but the idea is you get a list of all the terms with anchor links to the definition and relevant documentation pages. Have to look into why it's not generating a right TOC for the H2 (my theory is because it is declared in the shortcode file rather than glossary.md?

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

Add sorting

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

Address feedback

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

Escape quotes

* Add initial list of terms
Add anchorize function

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

Remove duplicate entry

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

* Remove extra spaces

* Add initial list of terms
Add anchorize function

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

Remove duplicate entry

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>

* Remove extra spaces

* Use 3 columns and other cleanup

- 3 columns for term index
- Use shortcode instead of `if` check in `single.html` layout
- Minor cleanup

* Address feedback

Signed-off-by: bermudezmt <bermudez.mt@gmail.com>
2019-09-09 13:56:35 -07:00
Christian Nunciato
f092123173 Minor nav fixes (#1705)
* Show (and hide) the submenu when scrolled
* Decrease the mobile font size of the home-page alert, to wrap less often
2019-09-09 12:07:56 -07:00
Justin Van Patten
0285b95ccd Minor Python styling improvements (#1690)
- Only show a single H1 per page
- Cleaner breadcrumb titles
- Minor styling adjustments
- Regenerate Python docs
2019-09-04 20:29:48 -07:00