Ribbit-Network / ribbit-network-frog-hardware

The sensor for the world's largest crowdsourced network of open-source, low-cost, GHG Gas Detection Sensors.
https://www.ribbitnetwork.org/
MIT License
94 stars 26 forks source link

Create Hardware Block Diagram #60

Closed keenanjohnson closed 2 years ago

keenanjohnson commented 2 years ago

A big improvement to the public documentation would be a proper hardware block diagram.

tomcircuit commented 2 years ago

I would like to contribute here. It’s a great motivation for me to study the schematic. One potential hang-up is that I typically use MS Visio for block diagrams. I suspect that using a closed tool for this project is frowned upon, if not completely verboten? I’ve experimented with Open Office draw and walked away disappointed. Any suggestions for a suitable tool that can output PNG or SVG for the docu?

lwbantoto commented 2 years ago

draw.io and lucidchart

On Thu, Oct 28, 2021 at 7:22 AM Tom LeMense @.***> wrote:

I would like to contribute here. It’s a great motivation for me to study the schematic. One potential hang-up is that I typically use MS Visio for block diagrams. I suspect that using a closed tool for this project is frowned upon, if not completely verboten? I’ve experimented with Open Office draw and walked away disappointed. Any suggestions for a suitable tool that can output PNG or SVG for the docu?

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/Ribbit-Network/ribbit-network-frog-sensor/issues/60#issuecomment-953752325, or unsubscribe https://github.com/notifications/unsubscribe-auth/ABXHIJHN6VK6BCRUEKFT7SLUJEXAVANCNFSM5GZM6L6A .

keenanjohnson commented 2 years ago

Thanks @tomcircuit! Yes, I think your intuition is correct that we prefer tools that are accessible to everyone with minimum cost unless there is really no other alternative.

@lwbantoto mentioned some good options. I'm sure there are others. I would just try to pick something that is free to use and that the source document is easily accessible (can be committed to git or easily copied in a web platform).

lwbantoto commented 2 years ago

Here's a JPEG that I exported from draw.io: https://github.com/uwrobotics/MarsRoverHardware/blob/master/11-21-2020-block-diagram.png. It's a web platform so the source document is online, though it's integrated into Google Docs so version control is possible.