14 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
Joe Duffy
c099c47c80 Eliminate "real languages" from our website (#4032)
* Eliminate "real languages" from our website

We know that this terminology is unfriendly and can be seen as
gatekeeping. We've moved away from it over time, but there are many
traces of it in our documentation -- most notably, even on our
homepage. Instead of "real languages", let's use "familiar languages",
and in places where deeper explanation makes sense in context, we
can say "familiar, general-purpose languages."

The current 2nd-level blurb on the homepage isn't very good right now
anyhow, so this is a convenient change. As we make progress on various
marketing efforts, we will likely make more extensive changes, but
for now this at least fixes this problem. We recently A/B tested
updates without much of an impact, so let's move ahead with this change
and then if we want to test alternatives to "familiar", we can do that.
For instance, we considered "popular", etc.

* Also eliminate "real code"
2020-08-19 06:19:50 -07:00
Christian Nunciato
a9bdf70391 Fix up some ambiguous references (#2730)
* Remove unreferenced links
* Disambiguate links to /contact
2020-03-23 18:05:45 -07:00
Justin Van Patten
1976d06ad2 Use relref when linking within site (#2257)
This way, we'll get build-time errors if we've moved a page around and haven't fixed the link, and it ensures a trailing `/` is present in the generated URL, which avoids unnecessary redirect S3 redirect hops.
2020-01-16 15:28:35 -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
joeduffy
d32f026108 Fix formatting mistakes in blog post 2019-11-14 10:17:18 -08:00
joeduffy
a923447992 More Crosswalk/Kubernetes blog edits 2019-11-14 07:45:00 -08:00
joeduffy
0a93891af6 Tweak the opening sentence 2019-11-14 07:32:12 -08:00
Joe Duffy
1a2253593f Fix some content, add an image (#1979) 2019-11-14 07:15:28 -08:00
joeduffy
88073ab510 Add a Crosswalk for Kubernetes blog image 2019-11-14 06:46:51 -08:00
Eric Rudder
872f4715c3 small typo 2019-11-14 06:20:05 -08:00
Joe Duffy
b4672e6b09 Add the Pulumi Crosswalk for Kubernetes blog post (#1977) 2019-11-14 06:11:24 -08:00