* 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>
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`.
* 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>
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.
* 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>
* 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).
* 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>
* 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
- Instead, keep them with a "deprecated" note.
- Regenerate the docs (including updated docs for `@pulumi/kubernetes` v1.1.0 which has new deprecations.
* 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.
* 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>