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

Create Virtual Machine #184

Merged
merged 34 commits into from
Jun 19, 2019
Merged

Conversation

matthewcarleton
Copy link
Contributor

@matthewcarleton matthewcarleton commented May 23, 2019

This PR is updating the Create a VM to use the patternfly 4 style. It is still undecided what the final outcome will be (modal wizard, in-page wizard, or progressive form) so the purpose of this PR is to focus more on the content.

This PR will just be updating the basic step to keep it relatively small :) Follow PRs to come that will add networking, Storage, advanced, and review.
Some changes based on feedback and further design discussion:

The name and description has been moved to the bottom to allow for a better flow for auto generated names. If the user is presented the name first they will likely fill it out only to have it replaced by import or possibly template. There will be a follow up PR for a design that outlines the auto generated name field.

The "Create Virtual Machine" button remains active at all times for better accessibility support.

Inline alerts/notifications have been replaced with standard form errors to align better with form designs.

Some screens have been removed for the sake of brevity and to keep this design focused on the wizard itself. Open to feedback on that for sure.

One update to this design will be to possibly remove import entirely from this flow and create a separate "Import Virtual Machine" action. This will follow this PR.

There are some inconsistencies (colour, spacing, borders) in the sketch library that need to be updated. I've talked to Kyle about this and hopefully we can get the library updated so these designs can reflect that.

I'm curious what others think of the indented fields for provision source, I'm not sure we still need this but didn't want to change it in case there's a good argument for it.

Closes #186

@openshift-ci-robot openshift-ci-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 23, 2019
@matthewcarleton matthewcarleton changed the title Create vm Create Virtual Machine May 23, 2019
Copy link
Contributor

@lizsurette lizsurette left a comment

Choose a reason for hiding this comment

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

Wow...you crushed this...looks amazing with PF4 and I like that you are planning to focus on one step at a time rather than trying to tackle this whole beast in one :) Some small nits inline below.

web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
Copy link
Contributor

@andybraren andybraren left a comment

Choose a reason for hiding this comment

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

Dang Matt, this is looking great, thank you for breathing new life into this monstrous old flow! 😄


## Step 1: Basic

![Basic step](img/Step-1-basic-template.png)
Copy link
Contributor

@andybraren andybraren May 23, 2019

Choose a reason for hiding this comment

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

- May as well switch to RHEL 8 in this screen and all others
- I think everything in PF4 is supposed to be capitalized sentence-style except for product names. The “Create Virtual Machine” title and quick action button would then be “Create virtual machine”. Might be worth double-checking.
- Where do help icons go? PF4’s form documentation shows the help icon next to the input label, rather than within a FormGroup. Which is correct? (I hope the documentation)
- Should include an auto-generated name here since that’s the new default behavior.
- "Create new template from configuration" should be disabled when a Template is selected unless they tweak the Flavor of that template.
- Screens use Flavour but text uses ‘merican Flavor, we should check on this 😄

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The only thing with the auto generated name is that it might not always be generated. There is a possibility that the feature has been disabled OR they are creating a VM from scratch and haven't chosen any settings yet. This is the only one I left it empty though for that reason. There will be a follow up PR to focus on this feature specifically.

web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved

The latest recommended version should be pre-selected.

![OS error](img/Step-1-basic-Operating-system-3.png)
Copy link
Contributor

Choose a reason for hiding this comment

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

"Go to this page to learn more."

Maybe we should align with whatever the OpenShift pattern is here. I've been just putting hyperlinked "Learn more" text after the period of the previous sentence, but I'm not sure that's right either. We should figure that out.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

+1 Ya I was just adding this text to be more accessible.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I should also say that this is just placeholder not actually what it should say. It would hopefully be different for each to allow for a more descriptive text.

web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
@andybraren
Copy link
Contributor

I know this is the first of many PRs for this wizard, but to address some of the feedback from Summit, should a sixth (unclickable) "Results" step be added and the quick action button changed to something like "Review virtual machine" or "Review and create/import VM"?

@matthewcarleton
Copy link
Contributor Author

matthewcarleton commented May 25, 2019

@andybraren ya I could go either way on it. I was planning on leaving it for the review step since we won't change much there.

Copy link
Contributor

@serenamarie125 serenamarie125 left a comment

Choose a reason for hiding this comment

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

Matt what do you think of renaming "Basic" to "General"? Although we don't have anything in patternFly around this, I think we have had similar discussions in the past. @beanh66 @lizsurette do you have any thoughts on this?

Also, I think that the field level help is "I" icons rather than "?" - I think Michael c is updating that stuff

web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
@matthewcarleton
Copy link
Contributor Author

Matt what do you think of renaming "Basic" to "General"? Although we don't have anything in patternFly around this, I think we have had similar discussions in the past. @beanh66 @lizsurette do you have any thoughts on this?

Also, I think that the field level help is "I" icons rather than "?" - I think Michael c is updating that stuff

@serenamarie125 I'm fine to switch to General. I'll confirm with Michael about that, I am referencing what we currently have in PF. We'll need to update on the PF side too. Thanks!

Copy link
Member

@beanh66 beanh66 left a comment

Choose a reason for hiding this comment

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

@matthewcarleton This is looking great! It looks like the first image link is broken for me, can you check on that? Also wondering if we should add a summary at the beginning of this PR with links to the 5 steps so someone could jump down quickly since the "step 1" is already quite lengthy :)

@matthewcarleton
Copy link
Contributor Author

@beanh66 oh I'll take a look thanks!
Ya that's a good call I'll add some links :)

@openshift-ci-robot openshift-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 28, 2019
@openshift-ci-robot openshift-ci-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 28, 2019
@andybraren
Copy link
Contributor

Should this include the informational text that appears when clicking each info icon? Most of them are in the original doc, I believe.

@matthewcarleton
Copy link
Contributor Author

Should this include the informational text that appears when clicking each info icon? Most of them are in the original doc, I believe.

Good point @andybraren, @lizsurette and I talked about this and thought it made more sense to leave it out. That information is more relevant to the devs which they can get from the google doc.

@openshift-ci-robot openshift-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 5, 2019
@openshift-ci-robot openshift-ci-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 10, 2019
Copy link
Contributor

@lizsurette lizsurette left a comment

Choose a reason for hiding this comment

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

Other than 1 broken image (I think) and a minor typo nitpick I think this is good to merge.

WDYT @beanh66 ?

web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
web-console/knikubevirt/Create-vm/create-vm.md Outdated Show resolved Hide resolved
Copy link
Member

@beanh66 beanh66 left a comment

Choose a reason for hiding this comment

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

Looks good @matthewcarleton! Just left a minor note about the empty state. Also I'm not sure if that info icon is correct since usually it's not filled in. I don't think you need to change this in the mocks as long as we implement with the correct icon though. We can check with @mceledonia.


## Launching the Wizard

![Create VM](img/Create-VM.png)
Copy link
Member

Choose a reason for hiding this comment

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

We don't usually show two primary buttons at once. In OpenShift we leave the regular create button enabled and just don't use one in our empty states. PF4 seems to have it in the empty state but not sure it makes sense to remove or disable the other one. Want to remove it from the empty state?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

👍

Looks good @matthewcarleton! Just left a minor note about the empty state. Also I'm not sure if that info icon is correct since usually it's not filled in. I don't think you need to change this in the mocks as long as we implement with the correct icon though. We can check with @mceledonia.

yup just talked to him about this and we are moving back to the old icons. I'm updating now :)

Copy link
Contributor Author

@matthewcarleton matthewcarleton Jun 14, 2019

Choose a reason for hiding this comment

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

@beanh66 I've updated the empty state to show a secondary action in there.
Also, I've moved the "create vm" dropdown to the right, which is going to work better visually, when we add the actions dropdown it could just sit next to it. WDYT?
I agree on leaving these icons for now, there is still discussion going about going back to what we had initially or adding a custom info icon. That will just hold up this PR. We can come back and update things if we think it's need or as you said leave it to be updated in the build.

@beanh66
Copy link
Member

beanh66 commented Jun 19, 2019

This PR is updating the Create a VM to use the patternfly 4 style. It is still undecided what the final outcome will be (modal wizard, in-page wizard, or progressive form) so the purpose of this PR is to focus more on the content.

FYI @serenamarie125 @alimobrem, Per Matt's comments in the description of this PR, I am okay merging for now and revisiting form details when we are closer to 4.3 plans.

Copy link
Member

@beanh66 beanh66 left a comment

Choose a reason for hiding this comment

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

LGTM for content. We will revisit form details closer to 4.3 timeline.

Copy link
Contributor

@andybraren andybraren left a comment

Choose a reason for hiding this comment

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

Also LGTM as a faithful PF4-ified version of the old design. Just one last nit from me. 🙂


Only major version numbers are shown in the OS dropdown. The user selects one.

![OS minor version](img/Step-1-basic-Operating-system-2.png)
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: Minor version dropdown here should be 8.0 (or whatever's the latest) rather than 7.x. This applies to the next screen too.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update Basic step of Wizard to remove import
6 participants