hackforla / design-systems

Empowering every HfLA team to create their own design system. 🛠️ 🧰 Please see our readme for more info!
GNU General Public License v2.0
28 stars 1 forks source link

Cleanup of homepage, readme, and wiki #422

Closed kelenelee closed 2 years ago

kelenelee commented 2 years ago

Action Items

Through testing of the fork, the description cannot handle bullet lists or links. This is probably because the description populates as 1 paragraph of plain text under HfLA's list of repositories.

While we should still have some kind of description for the repo instead of it saying "No description provided," it's not clear whether something as simple as a sentence will help newcomers onboard or current members navigate and find information. Bulleted links would have been much more helpful for team members' tasks.

kelenelee commented 2 years ago

@allthatyazz can we get permission to edit the repo description? I might need to experiment with the copy?...

allthatyazz commented 2 years ago

@kelenelee Last time, I asked Bonnie how we can edit it, Bonnie responded that "What do you want the description to be? Put in the chat, [and] I'll edit it". So the implications for us:

kelenelee commented 2 years ago

Thanks @allthatyazz. Because I forgot to document it (haha how ironic) I forgot that I forked this repo, and in the fork I can push description copy as many times as I want.

allthatyazz commented 2 years ago

@kelenelee Very smart! I was thinking that you can even take the screenshots of your fork each time you change something and then use the screenshots in a poll or something if you want to collect some feedback from the team.

Also, I have a question for you. By any chance, do you have any screenshots from our original GitHub board?

kelenelee commented 2 years ago

@allthatyazz I don't have any old screenshots... I really regret not taking a screenshot of it. I think I'll go through old meeting recordings and see if it's there

allthatyazz commented 2 years ago

Try your best but if you could not get any good screenshots, then no worries at all. I guess we can use the other teams' boards as a reference too.

kelenelee commented 2 years ago

Hi @allthatyazz I've settled on a draft description. I don't have alternatives so I don't think I need to create a poll.

Empowering every HfLA team to create their own design system. 🛠️ 🧰 Please see our readme for more info!

If you're OK with this text, I think we can go ahead and have Bonnie paste that in. And also ask her to uncheck Releases Packages and Environments if we're not going to be using those:

Screen Shot 2022-06-01 at 6 51 39 PM

You can see a demo with the description here. Screen Shot 2022-06-01 at 6 53 31 PM

allthatyazz commented 2 years ago

Bonnie has been sick and our meeting cut short. We would do this once she becomes better.

allthatyazz commented 2 years ago

We completed the checklist during 11/7 Stakeholder meeting and added more tag lines. We ended up keeping the release.