updated license info

docs/changelog.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Changelog
 
 ## Image changelog

docs/community/trainings.md

@@ -8,6 +8,97 @@ The train the trainer program is a training program designed to equip individual
 
 This guide is intended to provide you with a solid foundation of knowledge and understanding about the PlanktoScope, enabling you to confidently develop and deliver your own training program for others. Whether you are an experienced user looking to share your expertise with others or a newcomer to the PlanktoScope looking to learn more about its capabilities and applications, this guide is designed to help you gain the necessary skills and knowledge to successfully teach others about this powerful tool.
 
+## Event types
+
+### Build workshop
+
+Organizing a build workshop can be a challenging but rewarding experience. It requires careful planning and execution to ensure that the workshop is successful. This trainer manual is designed to guide you through the process of organizing a build workshop.
+
+#### Selecting the production site
+
+Choosing the right production site for preparing and manufacturing the PlanktoScope Kits is an important step in the workshop planning process. The production site should have the necessary tools and equipment, as well as the knowledge and expertise to manufacture the PlanktoScope Kits. Here are a few things to consider when choosing a production site:
+
+1. **Check the Manufacturing and Assembly Guides**: Before choosing a production site, make sure to review the PlanktoScope [Manufacturing Guide](/hardware/manufacturing/) and the [Assembly Guide](/hardware/assembly_guide/). These guides will provide detailed information on the necessary tools and equipment required for the production of the PlanktoScope Kits.
+1. **Visit [Fablab](https://fablabs.io/labs) and [Hackspaces](https://wiki.hackerspaces.org/List_of_Hacker_Spaces)**: Consider visiting Fablabs or Hackspaces in your region. These organizations often have a culture of openness and may be willing to support you with your project. They may have the necessary tools and equipment to produce the PlanktoScope Kits, as well as the knowledge and expertise to guide you through the production process.
+1. **Commercial Manufacturing**: Look for a facility that has the capability to handle small scale production runs, a good quality control process and a logistic plan to ship the product to the final destination. Many
+
+!!! tip
+
+    For the PlanktoScope case, for example, you can look for woodworking companies. They often have a CNC machine and are familiar with the process of ditigal production.
+
+#### Material procurement
+
+Building a PlanktoScope requires a specific set of materials. In order to ensure that the workshop runs smoothly and that all attendees are able to successfully build their own PlanktoScope, it is important to properly plan and execute the procurement of materials. The following is a step-by-step guide on how to properly plan and execute the procurement of materials for a workshop:
+
+1. **Prepare the order list**: Use the bill of materials (BOM) as a starting point to create a comprehensive list of all materials needed for the workshop. Expand it with additional columns for suppliers, delivery dates, prices, shipping costs, and import taxes.
+2. **Plan for packaging**: Plan for extra packaging so you can assemble the parts as shown in the instructions. Try to minimize plastic as much as possible.
+3. **Research suppliers**: Research suppliers and see if there are local options, if you can consolidate orders to save costs and ensure timely delivery.
+4. **Compare prices**: Compare the prices of different suppliers to minimize the total cost.
+5. **Plan for spare parts**: Plan for spare parts in case something is broken or lost.
+6. **Check your Budget**: Check your budget and ensure that you have enough funds to cover the cost of all materials, shipping, and any additional expenses before placing your orders.
+7. **Place orders**: Once you have identified the best suppliers, place orders for all of the materials that you need. Be sure to factor in lead time when placing orders to ensure that the materials will arrive in time for the workshop.
+8. **Track orders**: Keep track of your orders and expected delivery dates, mark a component when it arrives. Contact suppliers if there are any delays or problems with delivery.
+9. **Communicate**: Communicate with participants if there are issues with timely delivery. It may make sense to postpone the workshop if there is not enough time to prepare and test everything. The participants will be grateful and will understand if it helps to ensure that everything runs smoothly.
+
+By following this process, you can ensure that all materials are procured and organized well in advance of the workshop, to avoid any last-minute delays or complications.
+
+!!! note
+
+    If you have difficulty finding the components you need, [contact us](https://planktoscope.slack.com/) and we will be happy to help you find the right alternative.
+
+!!! warning
+
+    Have a backup plan and be prepared for unexpected events that may occur during the procurement process. Allow two months for delivery, as some specialty parts may travel a long way and require additional time for customs inspection.
+
+!!! tip
+
+    Let us know your results, we would love to hear what solutions you found and how cost effective you were able to make the PlanktoScope.
+
+#### Prepare the Kit
+
+Kit preparation for the workshop is an important step in the preparation process. This ensures that participants have the materials and equipment they need to complete the workshop and build their own PlanktoScope. Here are a few things to keep in mind when preparing the kits:
+
+1. **Review the Bill of Materials (BOM)**: Review the Bill of Materials (BOM) for the PlanktoScope to ensure that you have all the necessary parts and materials for the workshop. The parts list can be found in the [Assembly Guide](/hardware/assembly_guide/) and lists all components and quantities needed to build a microscope.
+2. **Divide the kit components according to the BOM**: Once the materials have been received, divide the kit components from the orders according to the Bill of Materials (BOM) of the PlanktoScope. This will ensure that each participant receives the correct components and that there are no missing parts.
+3. **Have extra components**: Have extra components on hand in case of any missing or damaged parts during the workshop.
+4. **Package the kits**: Package the kits in a way that makes it easy for the participants to find and use the components during the workshop.
+5. **Label materials**: Label the packages as described in [Assembly Guide](/hardware/assembly_guide/) so that they are easy to find and distribute during the workshop.
+6. **Preparation of the housing parts**: Prepare the housing parts by applying the surface sealant and insert the nuts to screw the housing as described in the [Manufacturing Guide](/hardware/manufacturing/#finishing).
+7. **Cutting and soldering of electronic cables**: Cut and solder the electronic cables for the PlanktoScope. This will save time during the workshop and ensure that the participants have all the necessary cables to complete the assembly.
+8. **Setting up the embedded development environment**: Set up the embedded development environment and flash the eeprom of the PlanktoScope hat. This will ensure that the PlanktoScope hat is ready to be used during the workshop.
+9. **Download the Raspberry Pi image**: Download the Raspberry Pi image and flash it to the SD card. This will ensure that the participants have a ready to use image for the PlanktoScope.
+10. **Test the kits**: Test the kits before the workshop to ensure that all components are working correctly and that the instructions are clear and easy to follow. This will help to ensure that the participants have a positive and productive experience during the workshop.
+
+!!! tip
+
+    Identify any items that are time consuming during the workshop and not particularly important or complex to explain. These tasks can be completed in advance to save time during the workshop. This will make it easier for the participants to assemble the PlanktoScope during the workshop.
+
+#### Conducting the workshop
+
+It's finally here! After all the planning, preparation, and anticipation, the build workshop is about to begin. Take a deep breath and let's go!
+
+1. **Prepare the presentation**: Prepare the presentation device and start your slides.
+2. **Check-In**: Once the Participants arrive, complete the check-in, share the agenda and set expectations for the workshop.
+3. **Venue**: Provide information about the venue, including where to find restrooms and where to buy food.
+4. **Digital tools**: Provide information about the digital tools that will be used during the workshop, such as the platform for collaboration, the survey tool and the chat channel, and how to access them.
+5. **Data privacy**: Provide information about the data privacy policy and the forms that need to be signed by the participants.
+6. **Introduction**: Begin with a round of introductions and give everyone a chance to introduce themselves, their background, and their interest in the project.
+7. **Overview**: Provide details about the project, including the general mode of operation, the working materials such as the kit, the documentation and the git repository.
+8. **Kits and Tools**: Provide the Kit and Tools to each participant with a kit and the necessary tools.
+9. **Follow your Presentation and ** as described in the "Preparing a Presentation" section
+
+!!! tip
+
+    Paint the big picture and communicate progress to the participants. Activate and engage with the participants, and make sure to check-out and wrap up the workshop.
+
+### Field trip
+
+Are you an expert in organizing field trips? Share your skills with the PlanktoScope community by documenting the process! By documenting how you organize a field trip, you can help others create successful events and bring more event options to the PlanktoScope community. Your documentation will be a valuable resource for anyone looking to plan a field trip, and it will also help to grow and strengthen the PlanktoScope community. Don't miss this opportunity to contribute to the community, start documenting your process today!
+
+### Hackathon
+
+Are you a master at organizing Hackathons? Share your knowledge with the PlanktoScope community by documenting the process! By documenting how you organize a Hackathon, you can help others create successful events and bring more event options to the PlanktoScope community. Your documentation will be a valuable resource for anyone looking to host a Hackathon, and it will also help to grow and strengthen the PlanktoScope community. Don't miss this opportunity to contribute to the community, start documenting your process today!
+
 ## General planning methods
 
 Organizing a workshop can be a challenging but rewarding experience. It requires careful planning and execution to ensure that the workshop is successful. This trainer module is designed to guide you through the process of organizing any type of event.
@@ -115,16 +206,6 @@ The location should be convenient and accessible for the participants, and shoul
 4. **Check for food provision**: Consider if there is a possibility to go shopping or how to provide food for the course participants during the workshop.
 5. **Check the environment**: Consider the environment of the location, make sure it is comfortable, has enough space and is well-ventilated for the workshop.
 
-### Accommodation
-
-If the workshop is taking place over multiple days and is located in a less populated area, accommodation options may be more limited compared to a larger city. However, it is still important to provide participants with comfortable and convenient accommodations that are close to the workshop location. Here are a few things to consider when planning accommodation for a multi-day workshop in a less populated area:
-
-1. **Research options**: Research all available accommodation options in the area. This includes hotels, bed and breakfasts, vacation rentals, and camping options.
-1. **Reach out to local businesses**: Consider reaching out to local businesses such as farmers, innkeepers, or small hotels. They may be able to offer accommodation options that are not listed online.
-1. **Communicate the information**: Clearly communicate the options and the information of the accommodation to the participants, providing them with detailed information including contact information, location, and instructions on how to book.
-1. **Distance**: Keep in mind that accommodation options may be farther away from the workshop location in a less populated area. Be sure to provide transportation information and options to help participants get to and from the workshop.
-1. **Offer options**: Offer a variety of accommodation options to accommodate different preferences and budgets.
-
 ### Announcing the event
 
 When announcing the event, it is important to include the following information:
@@ -184,6 +265,8 @@ Make sure participants are well informed and can find their way to you by sendin
 
 ### Documenting the event
 
+Documenting a PlanktoScope workshop through photography is essential for several reasons. Photos can be used to showcase the workshop activities and the learning process of the participants. This can be useful for sharing information about the workshop with others, and for promoting future workshops.
+
 1. **Equipment**: Make sure you have the necessary equipment to document the event, including a camera (DSLR or mirrorless camera), lenses, memory cards, and batteries.
 2. **Backup**: Always make sure to have a backup plan for your equipment and photos, such as bringing extra memory cards and batteries.
 3. **Lighting**: Take into account the lighting conditions and make sure to have the right settings for your camera to capture the best possible images.
@@ -207,116 +290,6 @@ Follow-up activities are an essential part of the workshop planning process. The
 4. **Continual learning**: Provide additional training opportunities or resources for participants to continue their learning after the workshop. This could be through follow-up workshops, webinars, or online tutorials.
 5. **Track progress**: Keep track of the progress of the participants, check if they are applying what they learned during the workshop and give feedback to help them improve.
 
-## Event types
-
-### Build workshop
-
-Organizing a build workshop can be a challenging but rewarding experience. It requires careful planning and execution to ensure that the workshop is successful. This trainer manual is designed to guide you through the process of organizing a build workshop.
-
-#### Selecting the production site
-
-Choosing the right production site for preparing and manufacturing the PlanktoScope Kits is an important step in the workshop planning process. The production site should have the necessary tools and equipment, as well as the knowledge and expertise to manufacture the PlanktoScope Kits. Here are a few things to consider when choosing a production site:
-
-1. **Check the Manufacturing and Assembly Guides**: Before choosing a production site, make sure to review the PlanktoScope [Manufacturing Guide](/hardware/manufacturing/) and the [Assembly Guide](/hardware/assembly_guide/). These guides will provide detailed information on the necessary tools and equipment required for the production of the PlanktoScope Kits.
-1. **Visit [Fablab](https://fablabs.io/labs) and [Hackspaces](https://wiki.hackerspaces.org/List_of_Hacker_Spaces)**: Consider visiting Fablabs or Hackspaces in your region. These organizations often have a culture of openness and may be willing to support you with your project. They may have the necessary tools and equipment to produce the PlanktoScope Kits, as well as the knowledge and expertise to guide you through the production process.
-1. **Commercial Manufacturing**: Look for a facility that has the capability to handle small scale production runs, a good quality control process and a logistic plan to ship the product to the final destination. Many
-
-!!! tip
-
-    For the PlanktoScope case, for example, you can look for woodworking companies. They often have a CNC machine and are familiar with the process of ditigal production.
-
-#### Material procurement
-
-Building a PlanktoScope requires a specific set of materials. In order to ensure that the workshop runs smoothly and that all attendees are able to successfully build their own PlanktoScope, it is important to properly plan and execute the procurement of materials. The following is a step-by-step guide on how to properly plan and execute the procurement of materials for a workshop:
-
-1. **Prepare the order list**: Use the bill of materials (BOM) as a starting point to create a comprehensive list of all materials needed for the workshop. Expand it with additional columns for suppliers, delivery dates, prices, shipping costs, and import taxes.
-2. **Plan for packaging**: Plan for extra packaging so you can assemble the parts as shown in the instructions. Try to minimize plastic as much as possible.
-3. **Research suppliers**: Research suppliers and see if there are local options, if you can consolidate orders to save costs and ensure timely delivery.
-4. **Compare prices**: Compare the prices of different suppliers to minimize the total cost.
-5. **Plan for spare parts**: Plan for spare parts in case something is broken or lost.
-6. **Check your Budget**: Check your budget and ensure that you have enough funds to cover the cost of all materials, shipping, and any additional expenses before placing your orders.
-7. **Place orders**: Once you have identified the best suppliers, place orders for all of the materials that you need. Be sure to factor in lead time when placing orders to ensure that the materials will arrive in time for the workshop.
-8. **Track orders**: Keep track of your orders and expected delivery dates, mark a component when it arrives. Contact suppliers if there are any delays or problems with delivery.
-9. **Communicate**: Communicate with participants if there are issues with timely delivery. It may make sense to postpone the workshop if there is not enough time to prepare and test everything. The participants will be grateful and will understand if it helps to ensure that everything runs smoothly.
-
-By following this process, you can ensure that all materials are procured and organized well in advance of the workshop, to avoid any last-minute delays or complications.
-
-!!! note
-
-    If you have difficulty finding the components you need, [contact us](https://planktoscope.slack.com/) and we will be happy to help you find the right alternative.
-
-!!! warning
-
-    Have a backup plan and be prepared for unexpected events that may occur during the procurement process. Allow two months for delivery, as some specialty parts may travel a long way and require additional time for customs inspection.
-
-!!! tip
-
-    Let us know your results, we would love to hear what solutions you found and how cost effective you were able to make the PlanktoScope.
-
-#### Prepare the Kit
-
-Kit preparation for the workshop is an important step in the preparation process. This ensures that participants have the materials and equipment they need to complete the workshop and build their own PlanktoScope. Here are a few things to keep in mind when preparing the kits:
-
-1. **Review the Bill of Materials (BOM)**: Review the Bill of Materials (BOM) for the PlanktoScope to ensure that you have all the necessary parts and materials for the workshop. The parts list can be found in the [Assembly Guide](/hardware/assembly_guide/) and lists all components and quantities needed to build a microscope.
-2. **Divide the kit components according to the BOM**: Once the materials have been received, divide the kit components from the orders according to the Bill of Materials (BOM) of the PlanktoScope. This will ensure that each participant receives the correct components and that there are no missing parts.
-3. **Have extra components**: Have extra components on hand in case of any missing or damaged parts during the workshop.
-4. **Package the kits**: Package the kits in a way that makes it easy for the participants to find and use the components during the workshop.
-5. **Label materials**: Label the packages as described in [Assembly Guide](/hardware/assembly_guide/) so that they are easy to find and distribute during the workshop.
-6. **Preparation of the housing parts**: Prepare the housing parts by applying the surface sealant and insert the nuts to screw the housing as described in the [Manufacturing Guide](/hardware/manufacturing/#finishing).
-7. **Cutting and soldering of electronic cables**: Cut and solder the electronic cables for the PlanktoScope. This will save time during the workshop and ensure that the participants have all the necessary cables to complete the assembly.
-8. **Setting up the embedded development environment**: Set up the embedded development environment and flash the eeprom of the PlanktoScope hat. This will ensure that the PlanktoScope hat is ready to be used during the workshop.
-9. **Download the Raspberry Pi image**: Download the Raspberry Pi image and flash it to the SD card. This will ensure that the participants have a ready to use image for the PlanktoScope.
-10. **Test the kits**: Test the kits before the workshop to ensure that all components are working correctly and that the instructions are clear and easy to follow. This will help to ensure that the participants have a positive and productive experience during the workshop.
-
-!!! tip
-
-    Identify any items that are time consuming during the workshop and not particularly important or complex to explain. These tasks can be completed in advance to save time during the workshop. This will make it easier for the participants to assemble the PlanktoScope during the workshop.
-
-#### Conducting the workshop
-
-<!--
-- include brakes
-- start on the second day
-- departure
-- Define the purpose
-- Get to know the participants
-- Use visual aids.
-- Complete a check-in
-- Go over the ground rules
-- Share the agenda and set expectations
-- Build trust with an icebreaker
-- Facilitate, don’t control
-- Encourage (multimedia) documentation
-- Assess goal completion
-- Complete check-out
-- Communicate the next steps
-- Paint the big picture and communicate progress
-- Activate and engage
-
-Begin by introducing the concept of open-hardware and the principles that guide its design and development.
-
-Next, provide an overview of the hardware and software components that are commonly used in open-hardware projects, including microcontrollers, sensors, and prototyping platforms such as Arduino and Raspberry Pi.
-
-Introduce best practices for designing and building open-hardware devices, including how to select and source components, how to test and debug hardware and software, and how to document and share your work with others.
-
-Provide hands-on training in building a simple open-hardware device, such as a temperature sensor or a simple robotic system.
-
-Encourage participants to share their own ideas for open-hardware projects and provide guidance and support as they work on their own projects.
-
-Finally, discuss strategies for scaling up open-hardware projects and strategies for getting them into the hands of users and communities that can benefit from them.
-
-- mein Idee ist mehr Hintergrundwissen zum Design zu vermitteln
-
--->
-
-### Field trip
-
-Are you an expert in organizing field trips? Share your skills with the PlanktoScope community by documenting the process! By documenting how you organize a field trip, you can help others create successful events and bring more event options to the PlanktoScope community. Your documentation will be a valuable resource for anyone looking to plan a field trip, and it will also help to grow and strengthen the PlanktoScope community. Don't miss this opportunity to contribute to the community, start documenting your process today!
-
-### Hackathon
-
-Are you a master at organizing Hackathons? Share your knowledge with the PlanktoScope community by documenting the process! By documenting how you organize a Hackathon, you can help others create successful events and bring more event options to the PlanktoScope community. Your documentation will be a valuable resource for anyone looking to host a Hackathon, and it will also help to grow and strengthen the PlanktoScope community. Don't miss this opportunity to contribute to the community, start documenting your process today!
-
 ## Improve this training program
 
 As with any training program, there is always room for improvement. To ensure that this program continues to meet the needs of its attendees, it is important to actively seek feedback and make changes as necessary.

docs/contribute/github_workflow.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Contributing
 
 First of all, thank you for contributing to the PlanktoScope! The goal of this document is to provide everything you need to know in order to contribute to PlanktoScope.
@@ -41,6 +37,7 @@ This repository is also a good way to get involved. Please fill in an issue if y
 In order to use the different tools on this repository, you will first need to:
 
 ```sh
+
 ```
 
 ### Tests and Linter <!-- omit in toc -->

docs/contribute/software_development.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # How to help development for the PlanktoScope code
 
 We are using the [Github Flow approach](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests) for our development efforts.

docs/contribute/writing_documentation.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Writing Documentation
 
 The source files are in the main [github repository](https://www.github.com/PlanktonPlanet/PlanktoScope), in the `docs` folder.

docs/hardware/accessories.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Plankton Net
 
 A plankton net is a scientific tool used to collect plankton samples from aquatic environments. Plankton are small, drifting organisms that play a vital role in marine ecosystems. They include a diverse range of species, including bacteria, algae, protozoa, and small animals such as crustaceans and mollusks. Plankton nets are designed to capture these tiny organisms as they drift through the water column.

docs/hardware/assembly_guide.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Assembly guide of the PlanktoScope
 
 ## Content of the Kit

docs/hardware/hat_hardware.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # PlanktoScope Hat Hardware
 
 ![planktoscope_hero](./images/../../images/hardware/planktoscope_hat_front.png)

docs/hardware/manufacturing.md

@@ -112,10 +112,10 @@ There are two main types of electronic components that can be mounted onto a PCB
 ### Manufacturing files
 
 | Files                                                                                                                                          | Description                                     |
-| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
 | [Planktoscope-Hat-bom.csv](https://code.curious.bio/curious.bio/planktoscope/raw/branch/din_spec_3105_1/hardware/hat/Planktoscope-Hat-bom.csv) | The list of used SMD components                 |
-| [Planktoscope-Hat-gerber.zip](https://code.curious.bio/curious.bio/planktoscope/raw/branch/din_spec_3105_1/hardware/hat/Planktoscope-Hat-gerber.zip)     | The exported CAD and CAM data of the PCB design |
+| [Planktoscope-Hat gerber files](https://code.curious.bio/curious.bio/planktoscope/src/branch/din_spec_3105_1/hardware/hat/assembly)            | The exported CAD and CAM data of the PCB design |
-| [Planktoscope-Hat-assembly.zip](https://code.curious.bio/curious.bio/planktoscope/raw/branch/din_spec_3105_1/hardware/hat/Planktoscope-Hat-assembly.zip) | The SMD assembly instructions                   |
+| [Planktoscope-Hat assembly files](https://code.curious.bio/curious.bio/planktoscope/src/branch/din_spec_3105_1/hardware/hat/assembly)          | The SMD assembly instructions                   |
 
 ### PCB manufacturing process
 

docs/license.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Our work is fully open source
 
 That's the headline, yes.

docs/software/create_sd.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # How to create a new SD master card, or backup efficiently your existing card
 
 If you want to backup your machine, or prepare an image from the golden machine to share it to the world (or your students), you may want to follow those steps.

docs/software/easy_install.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # PlanktoScope Simple Setup Guide
 
 ## Download the image

docs/software/expert_setup.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Expert Setup
 
 ## Install and setup Raspbian on your Raspberry Pi

docs/software/update_devicetree.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Using a flash with the camera
 
 The Pi's camera module includes an LED flash driver which can be used to illuminate a scene upon capture. The flash driver has two configurable GPIO pins:

docs/usage/getting_started.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Getting started with using the machine
 
 Congratulations! You have [finished assembling](../hardware/assembly_guide.md) your machine, now is the time to test it and learn how to use it!

docs/usage/mqtt_messages.md

@@ -1,11 +1,10 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Details about used MQTT messages
 
 ## Topic lists
 
+- [Details about used MQTT messages](#details-about-used-mqtt-messages)
+  - [Topic lists](#topic-lists)
+  - [Topic details](#topic-details)
     - [`actuator`](#actuator)
       - [`actuator/pump`](#actuatorpump)
       - [`actuator/focus`](#actuatorfocus)
@@ -16,7 +15,6 @@ SPDX-License-Identifier: CC-BY-SA-4.0
       - [`status/focus`](#statusfocus)
       - [`status/imager`](#statusimager)
       - [`status/segmenter`](#statussegmenter)
-  - [`status/segmenter/name`](#statussegmentername)
       - [`status/segmenter/object_id`](#statussegmenterobject_id)
       - [`status/segmenter/metric`](#statussegmentermetric)
 
@@ -204,7 +202,7 @@ Status of the segmentation. It's a JSON object with:
 
 ```json
 {
-  "status": "Started",
+  "status": "Started"
 }
 ```
 

docs/usage/remote_access.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Remote access via a standalone network
 
 This tutorial is adapted from a tutorial that you can find [here](https://www.raspberryconnect.com/projects/65-raspberrypi-hotspot-accesspoints/157-raspberry-pi-auto-wifi-hotspot-switch-internet).

docs/usage/ui_guide.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # User interface guide
 
 Starting with the [release of v2.2](https://github.com/PlanktoScope/PlanktoScope/releases/tag/v2.2), a new user interface brings a whole new user interface. This guide will help you get familiar with it.
@@ -14,9 +10,9 @@ As you can see above, when you first connect with your planktoscope at [http://p
 
 From here, you can quickly access any of the available tabs. The buttons are only the most used functionnalities of the machine. Three others tabs are accessible only through the hamburger menu on the top left of the screen (the three horizontal lines):
 
-* Wifi
+- Wifi
-* Administration
+- Administration
-* Hardware Config
+- Hardware Config
 
 ![Tab List](../images/ui_guide/tab_list.webp)
 

flake.nix

@@ -1,4 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
 {
   description = "Nix PlanktoScope";
   inputs = {

mkdocs.yml

@@ -1,6 +1,4 @@
 ---
-# SPDX-License-Identifier: CC-BY-SA-4.0
-
 site_name: PlanktoScope
 site_description: An open and affordable imaging platform for \
   citizen oceanography

software/planktoscope-backend/README.md

@@ -1,16 +1,13 @@
-<!--
-SPDX-License-Identifier: GPL-3.0-or-later
--->
-
 # planktoscope-backend
 
 [![PyPI - Version](https://img.shields.io/pypi/v/planktoscope-backend.svg)](https://pypi.org/project/planktoscope-backend)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/planktoscope-backend.svg)](https://pypi.org/project/planktoscope-backend)
 
------
+---
 
 **Table of Contents**
 
+- [planktoscope-backend](#planktoscope-backend)
   - [Installation](#installation)
   - [License](#license)
 

software/planktoscope-backend/requirements.txt

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 RPi.GPIO~=0.7.1a4
 Adafruit-Blinka~=6.15.0
 adafruit-circuitpython-motorkit~=1.6.3

software/planktoscope-backend/src/planktoscope_backend/_version.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # coding: utf-8
 # file generated by setuptools_scm
 # don't change, don't track in version control

software/planktoscope-backend/src/planktoscope_backend/display.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Logger library compatible with multiprocessing
 from loguru import logger
 

software/planktoscope-backend/src/planktoscope_backend/imager/__init__.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 ################################################################################
 # Practical Libraries
 ################################################################################

software/planktoscope-backend/src/planktoscope_backend/imager/raspimjpeg.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 ################################################################################
 # Practical Libraries
 ################################################################################

software/planktoscope-backend/src/planktoscope_backend/imager/state_machine.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Logger library compatible with multiprocessing
 from loguru import logger
 

software/planktoscope-backend/src/planktoscope_backend/imager/streamer.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 from loguru import logger
 
 import time

software/planktoscope-backend/src/planktoscope_backend/integrity.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # This module calculates the checksum of created files and add them to and file called integrity.check
 # The file is composed as follows:
 # First, a header that starts by like so:

software/planktoscope-backend/src/planktoscope_backend/light.py

@@ -1,7 +1,5 @@
 #!/usr/bin/env python
 
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Turn on using this command line :
 # python3.7 path/to/file/light.py on
 

software/planktoscope-backend/src/planktoscope_backend/main.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Logger library compatible with multiprocessing
 from loguru import logger
 import sys

software/planktoscope-backend/src/planktoscope_backend/module.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 ################################################################################
 # Practical Libraries
 ################################################################################

software/planktoscope-backend/src/planktoscope_backend/mqtt.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Library for exchaning messages with Node-RED
 # We are using MQTT V3.1.1
 # The documentation for Paho can be found here:

software/planktoscope-backend/src/planktoscope_backend/segmenter/__init__.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 ################################################################################
 # Practical Libraries
 ################################################################################

software/planktoscope-backend/src/planktoscope_backend/segmenter/ecotaxa.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Logger library compatible with multiprocessing
 from loguru import logger
 

software/planktoscope-backend/src/planktoscope_backend/segmenter/encoder.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 import json
 import numpy as np
 

software/planktoscope-backend/src/planktoscope_backend/segmenter/operations.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Logger library compatible with multiprocessing
 from loguru import logger
 

software/planktoscope-backend/src/planktoscope_backend/segmenter/streamer.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 from loguru import logger
 
 import time

software/planktoscope-backend/src/planktoscope_backend/stepper.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Libraries to control the steppers for focusing and pumping
 import adafruit_motor.stepper
 import adafruit_motorkit

software/planktoscope-backend/src/planktoscope_backend/uuidName.py

@@ -1,5 +1,3 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 # Very inspired by https://github.com/bgawalt/uuidBabyName
 import re, uuid, random, os
 

software/planktoscope-frontend/flows/README.md

@@ -1,5 +1 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 The files present here are Node-RED flows easily shared via this `json` format.

software/scripts/README.md

@@ -1,7 +1,3 @@
-<!--
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
 # Python scripts of the PlanktoScope
 
 This directory contains the various scripts needed for the PlanktoScope to run properly.

software/scripts/bash/start_update.sh

@@ -1,7 +1,5 @@
 #!/bin/bash
 
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 log="echo -e"
 
 CURRENT_BRANCH=$(git --git-dir=/home/pi/PlanktoScope/.git rev-parse --abbrev-ref HEAD)

software/scripts/bash/update.sh

@@ -1,7 +1,5 @@
 #!/bin/bash
 
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 log="echo -e"
 
 CURRENT_BRANCH=$(git --git-dir=/home/pi/PlanktoScope/.git rev-parse --abbrev-ref HEAD)

software/scripts/bash/usb_backup.sh

@@ -1,9 +1,5 @@
 #!/bin/bash
 
-# SPDX-License-Identifier: GPL-3.0-or-later
-
-# Stolen from https://github.com/raamsri/automount-usb/blob/master/usb-mount.sh
-
 # This work is licensed under the Unlicense
 
 # This script is based on https://serverfault.com/a/767079 posted

software/scripts/raspimjpeg/macros/error_hard.sh

@@ -1,7 +1,5 @@
 #!/bin/bash
 
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 sudo killall -15 python3
 sudo killall -15 raspimjpeg
 sleep 10