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

Suggested updates to the sample network readme #19

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

Conversation

mbwhite
Copy link

@mbwhite mbwhite commented Jun 24, 2022

Therese are some suggested updates to make the overall 'flow' of the
readme.md better. So it easier for Fred/Fiona to follow along.

Also added a way of 'cheating' if you been through the tutorial before, then just a quick recap
of the commands is useful

Signed-off-by: mbw matthew@mh-white.com

@@ -12,20 +12,34 @@ Feedback, comments, questions, etc. at Discord : [#fabric-kubernetes](https://di

![sample-network](../docs/images/fabric-operator-sample-network.png)

## Prerequisites:
## Essential Setup
Copy link
Member

Choose a reason for hiding this comment

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

I like the term "essential setup"!

Copy link
Contributor

@jkneubuh jkneubuh left a comment

Choose a reason for hiding this comment

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

These are nice updates. I like the addition of just to just streamline the setup. Two minor requests:

  1. just kind seems nice, but just network or just sample-network or just everything seems more appropriate. Can we do this justice with perhaps just two just commands? (One for kind : set up kind and init the cluster, and a second target to bring up the network on some k8s?)

  2. The essential setup list is seeming "too long." Can we put the k9s and just sections into another section for optional / recommended software? Something like :

Essential Setup :

  • x
  • y
  • z
Fabric bin PATH stuff here

Optional Setup:

  • k9s
  • just

Kubernetes

...

?

@mbwhite mbwhite force-pushed the sample-network-docs-updates branch 2 times, most recently from e415203 to 0bca544 Compare July 8, 2022 12:45
@mbwhite
Copy link
Author

mbwhite commented Jul 8, 2022

@jkneubuh I've updated the readme as per your suggestions...

Therese are some suggested updates to make the overall 'flow' of the
readme.md better.  So it easier for Fred/Fiona to follow along.

Also added a way of 'cheating'  if you been through the tutorial before, then just a quick recap
of the commands is useful

Signed-off-by: mbw <matthew@mh-white.com>
@mbwhite mbwhite force-pushed the sample-network-docs-updates branch from 0bca544 to 5ff6654 Compare July 8, 2022 15:34
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

Successfully merging this pull request may close these issues.

4 participants