akash-network / website

Repo for the Akash Network Website.
https://akash.network/
Other
10 stars 17 forks source link

docs: improve accessibility of visualizations in engineering docs #173

Closed tgrecojs closed 5 days ago

tgrecojs commented 2 months ago

While viewing the pages on an ipad i found myself unable to read the text inside the diagram shown within the engineering doc's provider service page.

Click the link above or navigate to: engineering docs > Akash Provider Operators > Provider Service and you'll see the view shown in the image below.

akash-visualization

feedback from others would be great as i'd like to ensure i'm not the only one who finds the text on the image difficult to read. there are tools for doing such analysis but not sure of them off the top of my head and would need to do some research.

i think modifying the images all together would be ideal but i am not sure what the timeline would be for something like that. @HoomanHQ what are your thoughts on implementing a modal, or some feature would would make it easy or users to see a zoomed-in version of the image? if we had that, then we could use it whenever images like the one above appear. Notes: this isn't the only instance where this occurs (look around engineering docs)

tgrecojs commented 2 months ago

Below is a screenshot from graphics i found on the general information page.

ss_04272024_000316

I feel as though updating the current graphics to make use of this color scheme would seemingly fix the issue. If we needed zoom functionality as well, then that's no problem, but I think that it would be beneficial to the network if these visualizations were modified to look like the one on that page i've linked to. In addition to being more accessible, i think it looks much more professional (for lack of a better term).

@brewsterdrinkwater what level of effort would it take to get such changes made to these images in the docs? i'm not sure of the total number of images that need updating but i don't think it'd be > 4-5.

hiroyukikumazawa commented 2 months ago

I will solve this

hiroyukikumazawa commented 2 months ago

https://drive.google.com/file/d/1yjg5E8xwgk1QBkQL-rVF2y5UKpJk1YbJ/view?usp=sharing We can drop each frame as svg or image and integrate to our website. How about this approach? @HoomanHQ

image

hiroyukikumazawa commented 2 months ago

akash drawio akash drawio (1) akash drawio (2) akash drawio (3) akash drawio (4)

hiroyukikumazawa commented 2 months ago

How is it going?

HoomanDigital commented 2 weeks ago

@hiroyukikumazawa are you working on this issue still? we just need to update few graphics in engineering docs as suggested in this issue..

The graphics you have created seems gtg, you can consider doing the same for others.

Thank you

hiroyukikumazawa commented 2 weeks ago

This is the draft of above image. https://drive.google.com/file/d/1yjg5E8xwgk1QBkQL-rVF2y5UKpJk1YbJ/view?usp=sharing

HoomanDigital commented 1 week ago

here are the new refined images for eng-docs: https://drive.google.com/drive/folders/1ZJQvVFhMsua9E5zgSLiyHCMMJ5rR_NRd?usp=sharing

cc @hiroyukikumazawa

HoomanDigital commented 5 days ago

resolved