Closed thessaly closed 2 years ago
Fixed everything in PR #40
Yes
Yes
* I'd remove references to the canvas here, basically replace 1st paragraph with:
As part of this module you will learn what is the scope your project and why it's important to define it; you will hear about the different types of projects based on their relation to existent ones, and we will guide you through the building blocks you need to consider, with a focus in your project home.
As part of this module you will learn how to scope your project and why it's important to define it. You will hear about the different types of projects based on their relation to existing ones. We will guide you through the various building blocks you need to consider for building your open hardware project.
* I'd change the bullets for numbers, as later on I refer to the questions with numbering
- fixed that
- I changed in summary "Delimit the scope" to "Define the scope" because I think define is more common language
- changed delimiting > defining also in the text.
- changed ... detailing now > we will discuss in detail now (simpler language?)
- wrote and between "device to produce air quality data or air quality AND water quality data" in caps
* I'd add a closing paragraph to the "The minimum you need to get there" section, something like this:
Think of the necessary materials and steps you need to follow, to achieve that minimum piece of work that satisfies the goal you defined in the previous module.
* [The project triangle](https://www.youtube.com/watch?v=YOkOPN7EcuQ&t=1s) * [Setting SMART goals](https://www.mindtools.com/pages/article/smart-goals.htm) * [Definition of Output, Outcome and Impact with Examples](https://analyticsinaction.co/definition-output-outcome-impact-with-examples)
- added them
* [Reinventing the Wheel - Wikipedia entry](https://en.wikipedia.org/wiki/Reinventing_the_wheel) * [When reinventing the wheel does make sense](https://hackaday.com/2021/05/08/reinventing-the-wheel/)
- added them
* [Overview of the Various Types of Hardware Prototypes](https://www.hackster.io/news/overview-of-the-various-types-of-hardware-prototypes-60d33d92e3a3) * [OSHWA - Best practices for Open source Hardware 1.0](https://www.oshwa.org/sharing-best-practices/)
- added them
Yes, I think it makes sense. I'd only replace the sample statement with an example closer to open hardware (this was Mozilla's example), and make sure to highlight/colour the key parts in the statement skeleton
- I changed the example statement: I’m working with plant scientists in Boston to develop a remote sensor to measure plant water content, so it can be used in areas with water shortage to efficiently water crop plants to sustain supply of drinking water and food.
Yes, makes sense, they go back to the canvas and review. Also documenting prototypes ideas is good for fostering doc practice.
- I strongly agree
Feels natural to ask them to draft a home page, it will help them decant ideas about their goals also. I agree
In the introduction we already mentioned some terms that we will be detailing more now. For example: you may be developing an environmental monitoring tool, but is the goal of the device to produce air quality data or air quality and water quality data? Finally, question 4 asks about your motivation to work on this project. It makes you think of what would be different in the world if your project already existed.
- fixed them
Software and firmware: if your project needs code to run, include the source, dependencies, version and state (stable or not?).
- fixed
- broad idea about what open hardware is
This is another advantage of making web pages with GitHub/GitLab: you can easily update the website just by modifying the README or source file.
- fixed that
Do you agree with the content?
Yes
Do you agree with the opinions/statements
Yes
Any content to add/remove?
Home
2.1 "Defining your project"
2.2 "Working smart"
2.3 "Building blocks overview"
2.4 "First impressions matter"
Nothing to add
Any more resources?
For 2.1
For 2.2
For 2.3
For 2.4
Can't think of any others
Are the assignments appropriate
For 2.1
Yes, I think it makes sense. I'd only replace the sample statement with an example closer to open hardware (this was Mozilla's example), and make sure to highlight/colour the key parts in the statement skeleton
For 2.2
Yes, I think this is a good assignment.
For 2.3
Yes, makes sense, they go back to the canvas and review. Also documenting prototypes ideas is good for fostering doc practice.
For 2.4
Feels natural to ask them to draft a home page, it will help them decant ideas about their goals also.
Typos
For 2.1
For 2.2
Couldn't find any
For 2.3
For 2.4