[📑 Docs]: Select color hex codes for Docs UML diagrams

[quetzalliwrites]

What Dev Docs changes are you proposing?

AsyncAPI brand-compliant colors for UML Diagrams in Docs

Now that the community has voted on which diagram tool to use, it is time for design contributors to guide us in handling colors in new UML diagrams about to be added to our Docs.

We need design contributors to provide feedback on which color hex codes and what % shades of each color to use.

Color system proposed

I would like to propose we follow the industry-standard UML coloring system first suggested by Peter Coad, Eric Lefebvre, and Jeff De Luca in their series of articles in The Coad Letter,[1][2] and later published in their book Java Modeling In Color With UML.[3]

Object Modeling in Color [4]

• 💓 pink (moment-interval) — Examples in business systems generally model activities involving people, places and things such as a sale, an order, a rental, employment, making a journey, etc.
• 💛 yellow (roles) — A person, place, or thing can play a role in an activity. Examples could be a person playing the role of an employee in employment, a thing playing the role of a product in a sale, or a location playing the role of a classroom for a training course.
• 💙 blue (description) — A catalog-entry-like description that 'labels' an object. For example, a car's make and model categorize or describe a number of physical vehicles.
• 💚 green (party, place, or thing) — The role-players in a system. People are green. Organizations are green. Physical objects such as a tablet, are green things.

Here's an example showcasing how to apply the UML color standard that comprises of four colors [5]:

UML Learning Resources

• Intro to UML Diagrams
• Colors in object modeling
• UML Class Diagramming tutorial
• Behavioral UML diagram and Structural UML diagram

---

cc'ing the people

• GSoD contributors: @Annysah, @thulieblack, @Florence-Njeri, @starlightknown, @nelsonmic, @pratik2315
• Mentors & Community: @derberg, @smoya, @fmvilas, @magicmatatjahu
• Design contributors: @mcturco, @dattavelivela

Code of Conduct

• [X] I agree to follow this project's Code of Conduct

[quetzalliwrites]

@mcturco (cc @dattavelivela), here is an example of a NEW Concept Doc for the spec term, server.

The UML diagram draft here by Thulie is one example of what our UML diagrams will cover and look like:

[quetzalliwrites]

@Dattavelivela are you still interested in being a design contributor for this issue?

Otherwise I need to ask @mcturco if she herself has time or if she can help me identify a new contributor 😀✨✨

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart: