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

Add prerequisites, adjust quick start installation & add architecture diagram #38

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

jlnhnng
Copy link

@jlnhnng jlnhnng commented Nov 14, 2024

  • Added new site with installation requirements
  • Moved requirements from Quick Start Installation to new site
  • Added architecture diagrams for dark and light theme
  • Added css for switch between dark and light image
  • Added glightbox feature for image zoom-in

@jlnhnng jlnhnng changed the title Add prerequisites & adjustment of quick start installation Add prerequisites, adjust quick start installation & add architecture diagram Nov 15, 2024
Comment on lines +1 to +12
## Requirements

Project 2A requires a Kubernetes cluster. It can be of any type and will serve as the 2A _management cluster_.

If you don't yet have a Kubernetes cluster, consider using [k0s](https://docs.k0sproject.io/stable/install/).

The following instructions assume:

- Your `kubeconfig` points to the correct Kubernetes cluster.
- You have [Helm](https://helm.sh/docs/intro/install/) installed.
- You have [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) installed.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure I'm a big fan of moving the requirements away from the Quickstart, this will require a first time user to go through 3 pages of documentation to have a cluster up and running (PreRequisites, General Quickstart and Infra specific Quickstart).
Could we leave the Requirements in the General Quickstart page, and reference to the additional prerequisites page?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, sure. I can pull the latest and work your feedback in.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you provide the source of this? so we can update it whenever needed?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In which format would you like the diagram? I can export it EPS or SVG. I've created it via Sketch. So, can be a sketch document as well.
Where is there best place to save the source?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In which format would you like the diagram? I can export it EPS or SVG. I've created it via Sketch. So, can be a sketch document as well.
yea let's upload the sketch file, so we have something that can be actually edited if needed by other people.

Where is there best place to save the source?

I would say also in the assets folder were the PNG lies

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In which format would you like the diagram? Only PNG?

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

Successfully merging this pull request may close these issues.

2 participants