This is an initial "experiment" on making codeblocks more useful; it's
just a quick implementation, and can use a lot of improvements, but we
can see if it's useful in its current form already (as a starting point).
More context below:
With example blocks being parsed/highlighted by rouge, we should be able
to pick keywords from them; for example, in the highlighted Dockerfile
examples, we can show tool-tips (even a hover-card) with more details
about the command.
Shell examples may be a bit more involved, but we could still detect;
- adjacent keywords (`docker` + `run` => `docker run`)
- with the yaml-docs we have (we could generate JSON and upload them
as a "database"), we could even do an AJAX call to dynamically
fetch flag descriptions, etc.
This very quick and dirty test adds tooltips to Dockerfile commands
in examples. When hovering, it shoulds a tooltip ("click for more
information about this command"), and when clicking, navigates to the
Dockerfile reference.
Ideally, we wouldn't navigate away from the current page for initial
details (instead, we should present a rich hoverbox / pane), to provide
the user with more details without interrupting the article they were
reading.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Indentation in some bullet-lists had one space too little, causing
code-highlighting to not work.
Also fixed some other minor issues.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This fixes various inconsistencies between the landing page and the
other pages by sharing more styles between both:
- fix homepage using a different color for the active tab
- fix homepage not having "hover" styles for the top navigation
I addition, this:
- fixes unwanted whitespace in the hamburger-menu on mobile
- fixes "active" menu item not being highlighted on mobile
- fixes left-side aligning of left-hand menu on desktop
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Document path conversion on Windows
* Minor formatting and style updates
* desktop/windows: minor fixes in troubleshoot
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
- Add missing code-hints (console, yaml)
- Consistently add an empty line after code-blocks
- Combine some examples where the output and the command were
put in separate blocks. With the "console" code-hint, this
is no longer nescessary.
- fix indentation in cloud/ecs-integration.md, which caused the
numbered-list to be interrupted.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* updated upgrade your plan
* Moved the purchase plan section before upgrade
Added an intro to the topic, reorganized the topic to display info on how to purchase a plan before we discuss how to upgrade an existing plan
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
Usha Mandya