dev-launchers / dev-launchers-platform

Monorepo for all DevLaunchers internal products and libraries used by the official platform
https://devlaunchers.org
GNU General Public License v3.0
41 stars 30 forks source link

[US - DEV] As MILES HARDIN, I want to see my idea’s status in a tag so that I can know where my idea is in the process to be approved by Dev Launchers #788

Open JulieMass opened 1 year ago

JulieMass commented 1 year ago

Considerations:

We need to include a tag for each idea in the dashboard page so Miles can know their respective statuses. For example: is an idea in workshopping, development, archived, closed, etc. phase? If it is in the "workshopping phase" then the label should show "workshopping" and so on.

Note:

Relevant documentation:

Acceptance criteria:


Sub-tasks:

Idea's status roadmap / flow:

image.png

image.png

IdeaSpace tag labels (with outdated color styles) and tags with updated colors from the New Universal design system styleguide: image

JulieMass commented 1 year ago

(CC. @dbradham)

@alicefate I created a user story for you to develop the idea statuses tags. We'll discuss definitions in more detail in today's meeting with Anwar. Please, after the meeting, can you estimate it 🙏?

JulieMass commented 1 year ago

Hey team! Please add your planning poker estimate with Zenhub @dbradham @alicefate @JulieMass @Nouri-Anouar

JulieMass commented 1 year ago

Hi @alicefate, I've included above in the ticket description, @Nouri-Anouar's designs for each status tag state, so you know the colors he defined for each one.

image.png

JulieMass commented 1 year ago

@dbradham is there a way the QA team can access the dashboad currently in staging? I'm asking so we can assign this ticket to them for their review.

JulieMass commented 12 months ago

(CC. @dbradham)

I'm gonna move this ticket to "blocked" because, unfortunately, I couldn't test it due to the author's issue 😔.

JulieMass commented 8 months ago

(CC. @dbradham)

I'm gonna move this ticket to "blocked" because, unfortunately, I couldn't test it due to the author's issue 😔.

Hey @dbradham I noticed that the reason this ticket was in the blocked column was actually because of an issue with the author. This wasn't letting us see the ideas in the dashboard. Also, staging is broken right now, so I wasn't able to double-check anything.

Anyway, do you still think Hindu could work on this ticket and update the labels like we discussed today? Or would the author issue prevent her from doing that?

Let me know what you think!

JulieMass commented 7 months ago

Hey there @Hindu-Priya !

So, after discussing with @dbradham, and since this ticket has been around for a while under the blocked column, I went ahead and updated the acceptance criteria and added some new pictures. We just want to make sure the tag styles are in line with the new design system guidelines.

Also, for the second tag, I'm thinking we should change it from "Applying" to "In Review". The reason is that this tag is connected to the task Noa is working on, which is about “submitting an idea for review”. @NokaUX , let us know please what you think about this.

Hindu, I'm assigning this ticket to you, adding it to our current sprint (please update the ticket status once you start working on it) and let me know if you have any other questions!

Thank you

Hindu-Priya commented 7 months ago

Hey @JulieMass ,

Thanks for the update, @dbradham and @JulieMass. I've noted the changes to the acceptance criteria and the tag adjustment. @NokaUX, your thoughts on the tag change would be valuable. I'll get started on this ticket right away and update the status accordingly. Thanks!

JulieMass commented 7 months ago

Hey @JulieMass ,

Thanks for the update, @dbradham and @JulieMass. I've noted the changes to the acceptance criteria and the tag adjustment. @NokaUX, your thoughts on the tag change would be valuable. I'll get started on this ticket right away and update the status accordingly. Thanks!

Thank you Hindu! feel free also to update the final estimate if you need to.

Hindu-Priya commented 7 months ago

Sure Julie, will do it.

dbradham commented 7 months ago

@JulieMass my "deleted" idea is showing up here as "workshopping".

What is the expected behavior here?

image.png
ghost commented 7 months ago

IdeaSpace_Tags Hey @JulieMass and @Hindu-Priya ! I like the idea of changing the tags' name from "applying" to "in review", and agree with you on it, It does make more sense! Updating the Figma file accordingly, and attaching the updated diagram to this thread

JulieMass commented 7 months ago

@JulieMass my "deleted" idea is showing up here as "workshopping".

What is the expected behavior here? image.png

Hi @dbradham ,

For further information about how the flow for an idea works in IdeaSpace, the information is in our FAQ content document we created with Marilia.

I hope this helps clarifying,

(CC. @Hindu-Priya, @NokaUX )

JulieMass commented 7 months ago

IdeaSpace_Tags Hey @JulieMass and @Hindu-Priya ! I like the idea of changing the tags' name from "applying" to "in review", and agree with you on it, It does make more sense! Updating the Figma file accordingly, and attaching the updated diagram to this thread

IdeaSpace_Tags Hey @JulieMass and @Hindu-Priya ! I like the idea of changing the tags' name from "applying" to "in review", and agree with you on it, It does make more sense! Updating the Figma file accordingly, and attaching the updated diagram to this thread

Thank you @NokaUX for your feedback! @Hindu-Priya , let's move forward with the "in review" tag.

However, Noa, there seems to be some confusion, as there is no "review" step between an idea being submitted and it moving to the workshopping stage. The idea flow is described in a picture in this item’s description and I also mentioned this in the flow that you shared in our Discord Channel. Ideas move from “submitted” → “Workshopping” → “in review” (this is the task you are currently designing Noa in your ticket #1424) and finally an idea gets “approved” by Dev Launchers.

Here is a graphic that should help everyone to understand the ideas flow and also the tags that should be assigned correspondingly. This information is in our FigJam here:https://www.figma.com/file/uI7sKOvgtHhQYROxGgX2wq/%5BDL---IdeaSpace%5D-Story-mapping?type=whiteboard&node-id=0%3A1&t=shhTRWis2A23dPWj-1

@Hindu-Priya I'm updating this iteem description with this info as well so everything is updated.

image.png
Hindu-Priya commented 5 months ago

Hello @Enjoy2Live, @dbradham, and @JulieMass! As recommended, I tried to use Tailwind CSS to style the tag and can't seem to access Tailwind. Perhaps something is missing, for not being able to apply Tailwind CSS classes correctly.

Enjoy2Live commented 5 months ago

Hello @Enjoy2Live, @dbradham, and @JulieMass! As recommended, I tried to use Tailwind CSS to style the tag and can't seem to access Tailwind. Perhaps something is missing, for not being able to apply Tailwind CSS classes correctly.

Hi @Hindu-Priya , did you run yarn workspace @devlaunchers/tailwind dev? this command is responsible for watching the changes you make on the code and generate the classes you write to a css file found in packages/tailwind-constructor/tailwind.css so the command is always running and watching changes and shouldn't be terminated.

if you've already done this and your styles still don't apply can you please tell me which branch you're working on currently so I can investigate it further?

dbradham commented 5 months ago

@Hindu-Priya I am not seeing the expected results in staging after deploying here-

Screenshot 2024-06-29 at 3.22.10 PM.png
Hindu-Priya commented 5 months ago

Hello @dbradham,

Before merging into the master, it worked fine. After merging, it is behaving unexpectedly. @Enjoy2Live, I would appreciate your thoughts on it.

Enjoy2Live commented 5 months ago

@Hindu-Priya can you describe how it is behaving unexpectedly? steps to reproduce would help me figure out what went wrong.

Hindu-Priya commented 4 months ago

Hello @Enjoy2Live,

I'm not sure what went wrong, but it seems like Tailwind CSS isn't being applied to the tag.

Enjoy2Live commented 4 months ago

@Hindu-Priya I need steps to reproduce or the branch where you're having the issue otherwise I'm afraid I can't assist.

dbradham commented 4 months ago

@Enjoy2Live this change has been merged to branch master

Please see below for an example of the issue. The class name appears to have been rendered correctly, but no styles are applied to the element.

image.png image.png
chadcrotchett commented 4 months ago

BLOCKED: Chad coordinate with Mohammed

Enjoy2Live commented 4 months ago

@dbradham I see why, the className got changed from bg-Orange-orange-100 to bg-orange-100 because design team always decides on which format seems better fit, one way to find out before things get to staging or prod is by using our eslint config that I did a demo on some time ago.

It has a entry called "tailwind" and it does many helpful things like checking if the class you have applied exist in our tailwind config, orders classes so it can be easily read etc.

steps are easy tho no one seemed interested but now I hope this sparks some interest!

Here's the epic I made for each team to complete in order to have linting running https://app.zenhub.com/workspaces/platform-enablement-63529f02029ee50018fe58c6/epics/Z2lkOi8vcmFwdG9yL1plbmh1YkVwaWMvMTczNTg4 Link to the forgotten demo and announcement message I made https://discord.com/channels/829463953087660083/845028512841596978/1197991160476606484

Feel free to reopen the issue within this epic (I closed it out of frustration as no one really worked on it)

dbradham commented 4 months ago

@Enjoy2Live thanks for getting to the bottom of this!

One follow up here from my side, why is the design team changing the format/names of the classes for styling? Shouldn't that be static?

When Hindu was testing locally, this worked. But by the team she deployed to staging, it was broken by that change. That seems like the same issue would have happened here even if she were using the eslint tools, because the class name was valid at the time she implemented it.

My suggestion would be for the design team to update existing references to the tailwind classes when they change them, or avoid changing them altogether. Otherwise I believe we would repeat this problem in the future.

Enjoy2Live commented 4 months ago

@dbradham

why is the design team changing the format/names of the classes for styling? Shouldn't that be static?

A design system is something that evolves alot especially during its infancy and I understand your point of view because we're both developers but we want tokens to refer to a specific context so developers/designers know on top of their mind where to use a specific token and reduce the decision making when new features are in the making while supporting theming for the org in the future, the below img should give you an idea of how tokens can reduce decision making by applying subset of primitive colors [color-white] to predefined semantic tokens [bg-default] implying the default bg color should be white

image.png

Design tokens explained (and how to build a design token system) We're in the point of refining the way primitive tokens are named and soon enough we'll jump to write semantic tokens that would require us all to change tokens in each app from primitive tokens to semantic tokens.

At some point the changes will be minor and these types of errors shouldn't occur, we're not there yet so it's advised to use eslint now with CI in place while rebasing from master periodically to avoid these type of errors.

When Hindu was testing locally, this worked. But by the team she deployed to staging, it was broken by that change. That seems like the same issue would have happened here even if she were using the eslint tools, because the class name was valid at the time she implemented it.

We have thought of this and every time design team makes a PR that changes the tokens (found here btw) a CI job starts telling them what apps got their styling broken after the change, only apps that enabled our global eslint config though (so far no one uses it except @devlaunchers/components or global UI components lib). enable eslint config so I can get reports and every time a reference is broken I'll be sure to fix that on the spot before things even get to master.

Thanks for understanding!

dbradham commented 4 months ago

Thanks @Enjoy2Live for the explanation here. That is helpful to know why these changes are happening.

Just to recap-

Let me know if I am misunderstanding that, but it sounds like good incentive to implement eslint to me!

Enjoy2Live commented 4 months ago

@dbradham you got it right, telling other team leads about the issue you had might incentivize them to implement eslint.