MIPs icon indicating copy to clipboard operation
MIPs copied to clipboard

Add in a11y accessibility for the diagrams.

Open jmikedupont2 opened this issue 1 year ago • 3 comments

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 avatar Aug 20 '24 12:08 jmikedupont2

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 avatar Aug 20 '24 12:08 jmikedupont2

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

jmikedupont2 avatar Aug 20 '24 12:08 jmikedupont2

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

remigiusz-antczak avatar Aug 29 '24 11:08 remigiusz-antczak