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

Add in a11y accessibility for the diagrams. #21

Open
jmikedupont2 opened this issue Aug 20, 2024 · 3 comments
Open

Add in a11y accessibility for the diagrams. #21

jmikedupont2 opened this issue Aug 20, 2024 · 3 comments

Comments

@jmikedupont2
Copy link

The notion diagrams are great, but not so good for blind and disabled users and also bots.
For SEO and AI and other users with disabilities we should transcribe our digrams and notions into textual form like plantuml or dotty so that the ai can ingest them.

@jmikedupont2
Copy link
Author

from this diagram gemini is able to extract:

https://github.com/MinaProtocol/MIPs/blob/process-image-update/assets%2FMIP%20Process%20Diagram.jpg

Disclaimer: Due to the image quality and potential for errors in OCR (Optical Character Recognition), the following text is extracted to the best of my ability. It might contain inaccuracies or omissions.

Identified Text:

From the provided image, I can identify the following text elements:

  • Top Left Corner:

    • "Issue Raised"
    • "Available for voting using quadratic voting"
    • "1 week community discussion period"
    • "One week voting period"
    • "Requires 75% approval"
    • "Can be vetoed by Core Team"
  • Other Sections: (Less clear due to image quality and overlapping text)

    • Words like "Protocol," "Update," "Idea," "Draft," "Review," "Finalization," "Community," "Core Team," "Voting," "Approval," "Veto" appear in various boxes and connections.

Limitations:

  • The image quality is not optimal for accurate text extraction.
  • Overlapping text and small font sizes hinder precise recognition.
  • Without context, the meaning of some text elements might be ambiguous.

Recommendations:

  • If possible, provide a higher resolution image.
  • Manually transcribe the text from the image for accurate representation.
  • If the diagram represents a specific process, provide more details about it to aid in interpretation.

If you can provide more context or a clearer image, I can attempt to extract more text and potentially create a basic PlantUML or dot representation.

Would you like to try providing more context or a higher resolution image?

@jmikedupont2
Copy link
Author

jmikedupont2 commented Aug 20, 2024

ROyz2y90343t-nNXmB63WmWEKb643aAfqlreWmJlervoYlvwUoXYmJ5vxmLIifWeoLcbXCGY7AeQwXWwP5Rgc24KnHfqnPmG6aEClLRJyMriWtF9apnWHzmbPWfUmmhq7Ew8bp7wR-Iu3KB-_2j_DXbkXY66cx4PDtXD595XkPXfzILPsvCtbfv6ngjJqgA476z3H3YXSLgf4dsVttu1.png


title MIP Process

Start --> "Issue Raised"
"Issue Raised" --> "Community Discussion" : "1 week"
"Community Discussion" --> Voting : "1 week"
Voting --> Approval : "Requires 75%"
Approval --> Finalization
Approval --> Veto : "Core Team"

@enduml

https://www.planttext.com/?text=ROyz2y90343t-nNXmB63WmWEKb643aAfqlreWmJlervoYlvwUoXYmJ5vxmLIifWeoLcbXCGY7AeQwXWwP5Rgc24KnHfqnPmG6aEClLRJyMriWtF9apnWHzmbPWfUmmhq7Ew8bp7wR-Iu3KB-_2j_DXbkXY66cx4PDtXD595XkPXfzILPsvCtbfv6ngjJqgA476z3H3YXSLgf4dsVttu1

@remigiusz-antczak
Copy link

Thank you for raising it! We'll add it to our priorities and work on it soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants