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

Maintenance: Adjust directory layout. Naming things. Modernize documentation. #61

Merged
merged 4 commits into from
May 28, 2023

Conversation

amotl
Copy link
Member

@amotl amotl commented May 28, 2023

About

Directory layout

In order to clean up a bit, firmwares have now been grouped into subfolders by origin. In this way, the repository can grow further, but still everyone can feel at home, within their corresponding subdirectories. At the same time, benefits coming from shared CI and documentation infrastructure will be retained and even improved.

Naming things

By adding subdirectories, we are now able to detour from the previous directory layout and naming scheme, which was very strict and not optimal on different aspects. Now, the naming scheme aims to be more attractive for human consumption. The most notable changes are:

  • OpenHive firmwares have been renamed to openhive-gsm-wifi and openhive-yun. /cc @ClemensGruber, @bee-mois
  • The generic firmware has been renamed to backdoor/multihop. /cc @einsiedlerkrebs
  • Homie firmwares have been renamed to node-homie-basic, node-homie-lowpower, and node-homie-scale-adjust. /cc @Gulaschcowboy
  • node-esp8266-generic and node-esp32-generic have been renamed to trudering/bienenwaage-{2.0,5.0}. /cc @u-l-m-i

Modernize documentation

  • The documentation now uses the excellent Furo theme by @pradyunsg. Thank you!
  • There has already been some copy-editing, but there will be subsequent iterations on the documentation content, bringing in style improvements using sphinx-design, and fixing broken links.

amotl added 4 commits May 28, 2023 21:52
In order to clean up a bit, firmwares have been grouped by origin. In
this way, the repository can grow, but still everyone can feel at home,
within their corresponding subdirectories.

At the same time, benefits coming from shared CI and documentation
infrastructure will be retained and even improved.
@amotl amotl changed the title Maintenance: Adjust directory layout Maintenance: Adjust directory layout and modernize documentation May 28, 2023
@amotl amotl changed the title Maintenance: Adjust directory layout and modernize documentation Maintenance: Adjust directory layout. Naming things. Modernize documentation. May 28, 2023
@amotl amotl marked this pull request as ready for review May 28, 2023 20:10
@amotl amotl merged commit eeb4654 into main May 28, 2023
@amotl amotl deleted the amo/layout-and-docs branch May 28, 2023 20:15
@amotl amotl mentioned this pull request May 29, 2023
@amotl
Copy link
Member Author

amotl commented May 29, 2023

sphinx-design has been added to 1, using MyST, and sphinxcontrib-mermaid to 2. It looks so beautiful. Thank you all for your excellent work and keep up the spirit.

/cc @chrisjsewell, @choldgraf, @jpmckinney, @mgaitan, @hugovk, @bastiedotorg

Footnotes

  1. https://hiveeyes.org/docs/arduino/firmware/overview.html

  2. https://hiveeyes.org/docs/arduino/index.html#sensor-network-telemetry

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

Successfully merging this pull request may close these issues.

1 participant