33 Commits

Author SHA1 Message Date
Tim Gerla
c3a0302f17 docs: various layout and responsiveness fixes
- adjust ul margin to keep the bullets inside the content area
- fix a few docs page responsiveness problems on small screens
- adjust the layout of the logo relative to the docs sidebar
- clean up some vestigial CSS classes

Signed-off-by: Tim Gerla <tim@gerla.net>
2019-11-01 05:58:15 -07:00
Andrew Rynhard
6764170d1a docs: remove v0.2 docs
The v0.2 docs are inaccurate, and in general just bad. Since we made so
many breaking changes in v0.3 I think its better we just hit the reset
button and stick to v0.3 going forward.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-31 14:59:17 -07:00
Andrew Rynhard
96513ac397 docs: fix list-style-position
This sets the list-style-position to inside by default, and overrides
the landing page to use outside. This way we only need to maintain the
CSS for the landing page and not all the other potential places we would
want inside in the future.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-31 14:57:08 -07:00
Andrew Rynhard
2cad745292 docs: add customization guide
This adds a section on customizing Talos.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-31 14:47:17 -07:00
Andrew Rynhard
d39658a9ed docs: add VMware docs to menu
This adds the VMware docs to the sidebar menu and also touches up the
wording a bit.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-31 12:19:33 -07:00
Brad Beam
ca76ccd4af feat: Add support for creating VMware images
This PR adds support for generating VMware compatible images as an ova.

Signed-off-by: Brad Beam <brad.beam@talos-systems.com>
2019-10-31 13:39:54 -05:00
Andrew Rynhard
6e03adad06 docs: add troubleshooting guide on common PKI scenarios
This adds a "Troubleshooting" section to the documention along with a
guide on generating a certificate. This covers the scenario when a
user's certificate has expired.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-30 15:54:29 -07:00
Andrew Rynhard
6a61b3a1b2 docs: add note on CRNG initialization
This adds a note on the usage of random.trust_cpu to get around slow
boot times due to low entropy.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-30 14:12:31 -07:00
Andrew Rynhard
362134e2f2 docs: fix Digital Ocean docs
Fixes small typos, and errors in the tutorial.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-28 15:34:57 -07:00
Tim Gerla
8610a3f387 docs: more whitespace, wording, and responsiveness changes
- tweak whitespace between sections
- fix the top menu for small screens
- fix the terminal overlapping on small screens
- tweak wording on a few of the bullet points
- clean up the display of the "certified" logo on small screens
- clean up the "features" grid on medium/large screens

Signed-off-by: Tim Gerla <tim@gerla.net>
2019-10-28 10:50:01 -07:00
Andrew Rynhard
0d1c5ac305 feat: add support for Digital Ocean
This adds a Digital Ocean platform implementation.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-28 10:46:15 -07:00
Andrew Rynhard
a9fe8beb0f chore: fix markdown lint error
Dollar signs should only be used when the command has output.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-25 10:26:36 -07:00
Tim Gerla
b324217802 docs: responsiveness fixes and wording changes
- Most of the landing page is responsive on small/medium screens now. There are still
some bugs around the ascii cinema.
- Some wording tweaks, mostly I removed words to make things more concise. Feel free
to edit my edits.
- Simplified a couple of HTML constructs.
- Expanded the "features" section into two rows with a placeholder image for the 6th item.
Happy for feedback.

Signed-off-by: Tim Gerla <tim@gerla.net>
2019-10-24 15:43:23 -07:00
Andrew Rynhard
edf4ace611 docs: update getting started guide
Things have changed since v0.2. This is a refresh to make the getting
started guide up to date.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-23 15:23:04 -07:00
Andrew Rynhard
7a4b4d42b5 docs: add v0.3 AWS guide
This adds documentation for v0.3 AWS users.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-23 15:20:07 -07:00
Andrew Rynhard
49eaaec9b0 docs: improve asciinema casts
This replaces the existing casts with longer waits so that users can
parse the output.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-21 19:01:26 -07:00
Andrew Rynhard
12c650457e docs: remove header animation
This makes the header a fixed height without animation.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-21 18:34:47 -07:00
Andrew Rynhard
10ab444f71 docs: make the footer bigger
Big footers seem to be in style nowadays. This adds the CNCF log to the
footer and increases the footer height. It also moves the certified
Kubernetes log into the "What is Talos?" section.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-21 12:22:49 -07:00
Andrew Rynhard
e7424eec55 docs: improve landing page terminal
This removes the button hover color and sets the asciinema-player speed
to 1.0.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-21 08:15:20 -07:00
Andrew Rynhard
e3328aa6cb docs: add ephemeral feature note
This adds a feature about how Talos is ephemeral. I feel this is
important to get across to our users.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-21 06:21:58 -07:00
Andrew Rynhard
4f7b89ce6f docs: add API examples to the landing page
This uses the embeddable asciinema-player to show examples of the API in
the landing page.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-20 21:27:32 -07:00
Andrew Rynhard
5914a0c231 docs: improve landing page
This adds a little more space between the landing page items to make the
page a little more readable.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-20 19:13:07 -07:00
Andrew Rynhard
68d0798930 docs: make the sidebar sticky
Instead of floating the sidebar, we want it to be stick so that the
footer doesn't cover the bottom of the sidebar.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 20:40:35 -07:00
Andrew Rynhard
06aa63fbb3 docs: change doc content margins and padding
This bumps the content of a doc page up and drops the sidebar down.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 20:36:00 -07:00
Andrew Rynhard
d73bbbc9c5 docs: move docs version dropdown to docs page
This moves the documentation version dropdown menu into the
documentation page.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 20:14:24 -07:00
Andrew Rynhard
4252124009 docs: use horizontal containerd logo
The horizontal logo looks better than the stacked one when next to the
other logos.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 20:07:42 -07:00
Andrew Rynhard
17093416e6 docs: add FAQs page
The FAQs should be pulled out from the documentation as they are
specific to a version of Talos and more of a marketing message. This
adds a dedicated page for the FAQs.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 19:26:30 -07:00
Andrew Rynhard
7b801aa1bf docs: add community dropdown
This adds a dropdown menu to the header that makes it easy to find our
community links.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 19:01:20 -07:00
Andrew Rynhard
18f3596767 docs: improve dropdown menu
The adds shadow and border radius to dropdown menu.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 17:45:12 -07:00
Andrew Rynhard
d9dd55687b docs: show background only on landing page
The background should only be shown on the landing page.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 17:27:07 -07:00
Andrew Rynhard
6cc8a8bc04 docs: add landing page
This replaces the Mardown based landing page with a pure HTML approach.
This allows us to have a landing page that is much more impactful.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-19 14:45:47 -07:00
Andrew Rynhard
13d0e5840c docs: add v0.3 boilerplate
This adds the logic for handling multiple versions of documentation, and
adds a copy of the v0.2 docs as a starting point.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-18 23:46:12 -07:00
Andrew Rynhard
655aaa3149 docs: add documentation website
This will allow us to iterate faster on documentation for multiple
versions of Talos.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-10-18 21:28:40 -07:00