Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove duplicate install instructions #298

Open
Tracked by #294 ...
dwelsch-esi opened this issue Nov 5, 2024 · 0 comments
Open
Tracked by #294 ...

Remove duplicate install instructions #298

dwelsch-esi opened this issue Nov 5, 2024 · 0 comments

Comments

@dwelsch-esi
Copy link

FEATURE REQUEST: Remove duplicate install instructions

Overview

Rather than duplicating information in different scenarios (basic vs. advanced install), rewrite the pages so that no duplication is necessary.

The same applies to anywhere documentation has been duplicated by cut-and-paste.

There are several ways to do this:

  • Consolidate the pages so that the separate information is subordinate to the duplicated information rather than vice versa.
  • Put the duplicated material on its own page and link to it. This solution assumes that making the user click to a common piece of information is a lesser liability than trying to maintain the same information in two (or more) places. It usually is.
  • Put the dupilcate information on its own page and include in-line everywhere it's required (not easy to do here, since Markdown doesn't have a mechanism for that like the Restructured Text ".. include" directive.)

Context

This issue tracks recommended changes resulting from an analysis of the Litmus Chaos
documentation commissioned by CNCF. The analysis and supporting documents are
here: https://github.com/cncf/techdocs/tree/main/analyses under 0013-litmuschaos.

Possible Implementation

The following sections (and possibly others) are duplicated between the Basic Install and Advanced Install:

  • Prerequisites
  • Install Litmus using Helm
  • Install Mongo
  • Verify your installation
  • Accessing the ChaosCenter
  • Hosted (Beta) (information at the top of the tab)

Instead, consider consolidating the basic and advanced install onto one page using the following outline:

  • Installation (one page for both basic and advanced installation)
    • Prerequisites
      (the following two items could be in clickable tabs, or one after the other with a note to skip the one you don't use.)
    • Install Litmus using Helm
    • Install Litmus using kubectl
      (the following two items could be in clickable tabs, or one after the other with a note to skip the one you don't use.)
      • Basic install
      • Advanced install
    • Verify your installation
    • Accessing ChaosCenter

Alternatively, each main bullet item could be its own page, and each page linked to from its predecessor's "Next steps" heading at the end of the procedure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant