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

PR for [UX] Migrate existing markdown content to TSX pages #1056 Turn UX Design to Implementation #1077

Open
wants to merge 17 commits into
base: features/ux
Choose a base branch
from

Conversation

jamelachahbar
Copy link
Contributor

@jamelachahbar jamelachahbar commented Oct 27, 2024

πŸ› οΈ Description

#1056
PR for turning figma design into implementation.
Top Menu Bar, Sidebar + Sample Page created.
Tests created

πŸ“· Screenshots

image

Jest test results

image

πŸ“‹ Checklist

πŸ”¬ How did you test this change?

  • 🀏 Lint tests
  • [] 🀞 PS -WhatIf / az validate
  • πŸ‘ Manually deployed + verified
  • πŸ’ͺ Unit tests
  • πŸ™Œ Integration tests

πŸ™‹β€β™€οΈ Do any of the following that apply?

  • 🚨 This is a breaking change.
  • 🀏 The change is less than 20 lines of code.

πŸ“‘ Did you update docs/changelog.md?

  • βœ… Updated changelog (required for dev PRs)
  • ➑️ Will add log in a future PR (feature branch PRs only)
  • ❎ Log not needed (small/internal change)

πŸ“– Did you update documentation?

  • βœ… Public docs in docs (required for dev)
  • βœ… Internal dev docs in src (required for dev)
  • ➑️ Will add docs in a future PR (feature branch PRs only)
  • ❎ Docs not needed (small/internal change)

@jamelachahbar
Copy link
Contributor Author

@flanakin, I forget to sync with latest from ux branch. There are conflicts that need to be resolved.
Should we always create new branch with each change? This one contains the commits of the previews pr, only the last commit should be reviewed.

@jamelachahbar
Copy link
Contributor Author

jamelachahbar commented Oct 27, 2024 via email

@akiskips akiskips self-requested a review October 28, 2024 12:04
Copy link
Contributor

@akiskips akiskips left a comment

Choose a reason for hiding this comment

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

Tested deployment locally

{ name: 'PowerShell', icon: <FaCode />, route: '/powershell' },
{ name: 'Bicep modules', icon: <FaDatabase />, route: '/bicep-registry' },
{ name: 'Open data', icon: <FaCloud />, route: '/open-data' },
{ name: 'Learning', icon: <FaUserGraduate />, external: true, route: 'https://learn.microsoft.com/en-us/cloud-computing/finops/toolkit/finops-toolkit-overview' }, // External link
Copy link
Collaborator

Choose a reason for hiding this comment

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

Make sure you don't include locales ("en-us") in links. But in this case, can we create a dedicated page for this? We don't have one today, but we can copy the learning section of the home page as a starting point. It's okay if that happens in a separate PR.

Also, we should probably put learning resources first since you should learn about FinOps before you use all the tools that automate it πŸ€” (I know the mockup had it last. Sorry about that.)

Suggested change
{ name: 'Learning', icon: <FaUserGraduate />, external: true, route: 'https://learn.microsoft.com/en-us/cloud-computing/finops/toolkit/finops-toolkit-overview' }, // External link
{ name: 'Learning', icon: <FaUserGraduate />, external: true, route: 'https://learn.microsoft.com/cloud-computing/finops/toolkit/finops-toolkit-overview' }, // External link

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Okay, I can do that if it makes more sense. We probably need to brainstorm about 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.

When you say put learning resources first do you mean the order of things on the sidebar? So under home comes learning, then the tools?



// Styled components for layout and customization
const StyledCommandBar = styled.div`
Copy link
Collaborator

Choose a reason for hiding this comment

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

I feel like putting CSS in TSX is an antipattern. What do others think?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is what I started with when converting to CSS. These are styled components. I will convert to fluent ui if we get the same look and feel as a result. Then, we need to check if we can create global styles for components and call them out. I'm more than happy to change this and get input from others

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fluent uses Griffel and the makestyles is something I am using now for the finops home page. It is not here in this first pr, but we can have a working session to go through this and then I can adapt accordingly.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

New commit contains only fluent v2 with makeStyles

src/web/package.json Outdated Show resolved Hide resolved

export function PowerBIReportsPage() {
return (
<div style={{ display: 'flex', flexDirection: 'column', height: '100vh', overflowX: 'hidden', backgroundColor: '#f4f6f8' }}>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Why does this page have the TopMenuBar and SideBar explicitly called out? I didn't notice that in other pages.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It is an example of a page using the top menu bar and sidebar, the sample page has that too.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Do we need this file?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We don't it is just to be able to show the top menu bar and sidebar and get your comments in.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Shouldn't we put all images in an 'img' or 'images' folder? I'm not too picky on the name, but I'm assuming we'll want them organized in some way.

Copy link
Contributor Author

@jamelachahbar jamelachahbar Oct 29, 2024

Choose a reason for hiding this comment

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

What I would like us to do is to define the directory structure and define how we want the files to be organized. There is examples on the internet, but I'm interested in understanding how the internal teams organize this as well

Copy link
Collaborator

Choose a reason for hiding this comment

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

nit: sidebar-collapse.png
Does Fluent UI have an equivalent? Not a huge deal.

Copy link
Contributor Author

@jamelachahbar jamelachahbar Oct 29, 2024

Choose a reason for hiding this comment

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

I didn't find it, but I'll look into it.

Copy link
Contributor Author

@jamelachahbar jamelachahbar Oct 30, 2024

Choose a reason for hiding this comment

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

I exclusively used fluent in the last commit, just pushed it. Not the same as in the figma design, but I will go through the icons library and find an appropriate one, for now I used chevron.
image
image

Copy link
Contributor Author

Choose a reason for hiding this comment

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

After searching in the catalog of fluent v2, I found it. Will do a new commit soon.

src/web/public/sidebar-right-svgrepo-com.png Outdated Show resolved Hide resolved
src/web/tsconfig.json Outdated Show resolved Hide resolved
src/web/tsconfig.json Outdated Show resolved Hide resolved
Copy link
Collaborator

Choose a reason for hiding this comment

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

@Ivanmtta Creating this issue as a blocker for your review. Can you resolve this when you submit your review?

@flanakin flanakin added this to the Web app milestone Oct 31, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Needs: Review πŸ‘€ PR that is ready to be reviewed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants