Commit Graph

22 Commits

Author SHA1 Message Date
Tim Gerla
4debea6856 feat: allow deep-linking to specific docs pages
This changes the way the sidebar anchors are constructed, and if
there is an anchor in the URL, the Content component will render
the requested page, instead of just the top-level docs page.

Signed-off-by: Tim Gerla <tim@gerla.net>
2019-12-03 07:31:48 -08:00
Andrew Rynhard
714ae3e7c1 docs: add a project dropdown
The dropdown is a better place to group information about the project that
isn't documentation. This places the roadmap and use cases under the project
dropdown.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-11-11 21:48:34 -08:00
Andrew Rynhard
90fd52ad8c docs: fix roadmap layout
This adds margins to the roadmap to make it centered like the docs.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-11-10 15:59:51 -08:00
Andrew Rynhard
83ccbb1d2a docs: add public roadmap
This adds the first pass out our public roadmap. It is intended to be a
living document.

Signed-off-by: Andrew Rynhard <andrew@andrewrynhard.com>
2019-11-09 05:04:16 -08:00
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
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
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
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
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
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
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