Onboarding [Before Session #1]
ā›„

Onboarding [Before Session #1]

Before session #1, the idea is create a solid onboarding for the upcoming folks. The intuition here is that in the first 3 weeks of the group, youā€™d like a Core group skimmed out & onboarded with project essentials. That way, most group time can be used for creative exploration.
Ā 
Weā€™ve figured out a 3 part to help with that.
Please add the following to the landing page of your Working group, below the heading ā€˜Onboardingā€™.
Ā 

Part 1

Creating a ā€˜solution architectureā€™ for your group. That is a fancy way of saying that you have to break down the intended project to its component parts.
Find below a sample.
notion image
Ā 
notion image
We recommed using draw.io for this. And donā€™t worry if youā€™re not comprehensive the first time, you can always re-visit to tweak.
Note: Each box is essentially a ā€˜small taskā€™ in the project. How big or small said ā€˜taskā€™ is ultimately a judgement call. The one rule of thumb is ā€˜keep it small enough that it can be picked up & put in a project with a different datasetā€™.
The text near the shapes are techniques the group would like to explore.
Ā 
Ā 

Part 2

Create Recipes
A ā€˜Recipeā€™ is a list of resources that - when followed along - have you ā€˜do somethingā€™.
Put another way, you should be able to say for any Recipe.

Minimum Goal

By the end, a reviewer will have, with understanding ā€¦
Started from: [Default: Scratch]
  • Scratch
Succeeded at:
  • Building their first Neural network!
Ā 
To re-emphasize, not ā€˜teach you to be able to doā€™ ā€¦ but ā€˜have you doā€™.
Samples [Of the 4 common types of Recipes]:
A Recipe on obtaining domain knowledge: Satellite Image Interpretation. (Minimal domain knowledge critical for a good data scientist)
A Recipe on doing a non-coding task: Data Acquisition.
A Recipe on doing a typical coding task: Building landcover classification model.
A Recipe on learning a tool: Google Colab Essentials. (Agg Intellect groups are expected to use Colab for projects to ensure easy sharing unless a strong reason otherwise.)
Ā 
For each of the shapes in your solution architecture diagram, take time to create at least 1 onboarding Recipe.
Ā 
On how to create a Recipe, refer to the starter video below.
Ā 
notion image
PS. Write-up assets can be made directly using the Chrome Extension now.
Ā 
Ā 

Part 3

Once you have created a Recipe, the next step is ensuring it in fact does what it says it does.
Essentially, whatever you ā€˜wrote someone can get doneā€™ with the Recipe - weā€™ll have an independent reviewer do it. If there are gaps, they will coordinate to help fill.
For that reason, assign ā€˜Aggregate Intellectā€™ as the reviewer in your Recipe [as opposed to ā€˜auto assign reviewerā€™]. He will double check your work to ensure it runs robustly.
Be sure to send in all your Recipes for review at least 5 days session #1 of your group, and be active on the AISC Slack after. Your assigned reviewer/s will reach out to help fill in gaps with feedback.
Ā 
Ā 

Part 4

If all that seems a bit overwhelming, then donā€™t worry. To help save time, weā€™ve creating a growing ā€˜menu of validated recipesā€™ you can use as a starting point. Think building blocks for onboarding you can mix & match for your use case.
Ā 
How to use?
Take this ā€˜Training your first Random Forestā€™ Recipe from our menu. A reviewer has gone through it in detail to ensure it can be trusted.
In practice, applying Random Forests to your use case might need some additional pre-processing or tweaking. And chance are, you know the additional resources / can put together a small writeup that talk about said ā€˜additional stepsā€™.
Now instead of building a Recipe from scratch, that first teaches the foundations of Random Forests, then the specific kind of random forests you need, you can simply create a Recipe in Recipe.
Sample [Random Forests applied to Landcover data]
Refer to this tutorial on adding ā€˜recipes to recipesā€™.
Ā 
Our Menu of Recipes
Essential Tools
Common Models
Model Optimization related
Ā 
Ā 

Finished Sample


The below should be under the ā€˜Onboarding Headingā€™ on your landing page.
Ā 

Onboarding [Technical + Domain Knowledge]


Our tentative solution architecture
notion image
Recipes
Google Colab Essentials [Recommended virtual Environment for Agg Intellect community projects]
Ā 
Ā 

Part 5


Be sure to fill in a starter dataset on your landing page! [One exception: You have a Recipe that gets folks to the starter dataset themselves]
Eg.
Videos are provided of various amputees walking with prosthetics in various scenarios.
ā€¦ linked here ā€¦
The participants are welcome to independently source additional videos and images of amputees and prosthetics.
Ā 
Ā 
Ā