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 · 9 comments · May be fixed by #316
Open
Tracked by #294 ...

Remove duplicate install instructions #298

dwelsch-esi opened this issue Nov 5, 2024 · 9 comments · May be fixed by #316
Assignees

Comments

@dwelsch-esi
Copy link
Contributor

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.

@kef002
Copy link
Contributor

kef002 commented Dec 17, 2024

Can you please assign this Issue to me.

@namkyu1999
Copy link
Member

sure, @kef002 :) If there is no activity for two weeks, it may be assigned to someone else.

@dwelsch-esi
Copy link
Contributor Author

@kef002 I've been looking at this, and have a draft of a new install page done. I'd be happy to turn it over to you, to have you test the install, or collaborate in any other way you'd like. Please let me know what you'd like to do.

@kef002
Copy link
Contributor

kef002 commented Dec 20, 2024

Hello @dwelsch-esi , we can collaborate on this, I am going for Christmas Holidays on the 23rd and Will be back on the 2nd of January we can sync up on a call before I leave.

@dwelsch-esi
Copy link
Contributor Author

@kef002, There's not a lot of time to connect before the 23rd. Please let me know your availability. I'm in California, so PST time zone. Otherwise, have a great holiday and let's talk after the new year!

@kef002
Copy link
Contributor

kef002 commented Jan 6, 2025

Hello @dwelsch-esi , if you have already made a lot of progress on this you can take over, if not, we can have a meeting tomorrow at 9am PST which will be 5 pm Dublin time and work on it together.

@kef002
Copy link
Contributor

kef002 commented Jan 6, 2025

I have already asked to be assigned to two other Issues, so If the time doesn't work for you, you can take over this Issue

@dwelsch-esi
Copy link
Contributor Author

@kef002 I'm free tomorrow at 9 a.m. Can you please schedule a meeting and send me the invite?

@kef002
Copy link
Contributor

kef002 commented Jan 7, 2025

Hello @dwelsch-esi, set up the meeting for today. use the link below to access the meeting on zoom

Charlotte is inviting you to a scheduled Zoom meeting.

Topic: Remove duplicate install instructions #298
Time: Jan 7, 2025 05:00 PM Dublin
Join Zoom Meeting
https://us05web.zoom.us/j/7887404995?pwd=SjA4NzRWNEFWUWRDeXR6MWtCRFB3Zz09&omn=87011308757

Meeting ID: 788 740 4995
Passcode: bk52N1

@dwelsch-esi dwelsch-esi linked a pull request Jan 7, 2025 that will close this issue
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants