Project Managment / Principles and Practices Feedback
Hi John, good work!!! Still few issues to solve. Although it may seem you have to do a lot of improvements (I have written quite a lot of text) necessary changes can be solved quickly.
Principles and Practice Feedback
From Assessment guide
-
Sketched your final project idea/s -
Described what it will do and who will use it
Comments
About your website
Website is Ok. You are using the default mkdocs material them, but you have done certain tunning.
Final project website
-
As Neil always says: Use the Final project page as a diary. Try to write something there each week, explaining how each week's assignment has contributed to your final project.
- While you update the weekly assignments, include a short description on how each deadline has contributed to the final project. Add a link to that assignment, showing more detailed information.
-
Sincerely to keep the flow, I would change the order: First problem, then background, then problem domain (basically you explain why and how are you planning to improve your first iteration) and then explain your final project description.
-
It is not clear to me how the stretch goals are connected to your project. Here you are talking about IoT infra, while in the initial description of the project it looks it is a single node. Could you clarify?
-
I would add small text to the main diagram so the different parts are clearer.
-
For the lighting panel: have you considered using Neopixel. You could modify the colors depending on the type of plant, the brighness, the amount of light ...
-
All in all, very good project idea and within the limitations of fabacademy.
Project Management
From Assessment guide
-
Made a website and described how you did it -
Created a section about yourself on that website -
Added a page with a sketch and description of your final project idea(s) -
Documented steps for creating your Git repository and adding files to it -
Pushed to the class GitLab -
Signed and uploaded Student Agreement
Comments
About me website
- Perhaps you could have a link to the Bangor University and your Pontio Fablab page.
- If you want to discuss further about the Agri specialist center, you should discuss with Luc Hanneuse from AgriLab (France). Fab Lab Barcelona have some installations in the mountains where they develop agricultural projects, among other things. Let me know if you would like some contact information.
Description of the GIT process
- Add a link to a tutorial you follow and explain what you learnt from it.
- Explain what is git and what is gitlab. Why are we using it in Fab Academy?
- Explain why do you need to create a ssh key. Explain what exactly does ssh-keygen and what is the output of the command.
- Where do you insert the commands you mention to generate the SSH key? Which terminal are you using?
-
ssh-keyscan
is used to help ssh_known_hosts to define which hosts can be accessed with the provided keys. But it is not for "getting your system to pick up the public key from a remote system" - The command to let know the ssh-agent the keys is
ssh-add
notssh add
. Furthermore, the-l
just list the current fingerprints, does not store anything. - Explain what the commands
git config
does. Where do you insert those commands? Are you using a VS terminal or directly in your Mac terminal? - When you explain the source control with VS, please mark in the images where you have the icons you mention , for instance "Adding a message and hitting the plus at the top of the pane" Where is that + symbol in the image. I cannot see it.
- When you are using VS, please mark the commands that are executed in the background. It is important that you understand all GIT commands.
- You do not provide information on how do you clone first time the repo. Where do you get the clone URL?
-
git add
should be followed by the name of the files that you want to add to the stage are.
Description of the website
- Explain a little bit what is mkdocs (before showing how do you install it). Explain also what is a static site generator.
- Before explaining issues with markdown bulleted list, please, explain what is markdown and how it is linked to static site generators.
- Explain how did you modify the website from original template. For instance, how did you change the color? How did you add the leaf icon? Did you change some folder structure / add new folder? Explain how did you modify the mkdocs.yml file.
- Explain a bit on how gitlab CI/CD works and show which is the file which defines the CI/CD script. Also mention if you had to do any changes to the original file.
Description on how to setup your computer
- Pip is a package manager for python. You can only use this to install python packages, not any package. Please, clarify.
- You provide a very detail view on how to install different packages. But, how do you install
python3
? - You are using Visual Studio Code. Could you briefly explain what is it?
Other comments
- Minor ortographic mistakes: About me > focussed -> focused; Project Managament defualt > default, in covenient > incoveninent. In order to correct these problems, would be a good idea to run an automatic ortographic corrector.