Welcome to our lab's Onboarding Tutorial! By the end of this first part, you should:
Be able to use Twist for lab communication
Be able to use Todoist to manage your work and tasks you are assigned
Be able to use the GitHub GUI to modify lab files
Be able to edit the lab's wiki (this website) with GitBook
We use Twist instead of email in the lab to communicate with each other. Twist is kind of like slack, but it prioritizes long form messages.
Learn to create a thread in Twist by creating one on the #Lab Announcements channel to introduce yourself. On the #Lab Announcements channel, create a New Thread with the Subject: [YourFirstName] joins the lab! Use the Share your thoughts box to introduce yourself!
Most channels in Twist have a pinned thread called Quick Chat that we use for quick conversations with the whole lab. Try it out by saying hello in the #Lab Social channel's Quick Chat. The #Lab Social channel is for non-work things, so we we'd love it if you took this opportunity to share a picture of your dog, your favorite meme, a poem you like, or other fun stuff!
You can send a private chat to any member the lab via the Messages tab on Twist. Practice sending private messages by clicking New message and sending one to the lab manager, Ariel.
Learning when to ask for help is an important skill to master. In our lab, you should try a few things before asking for help: search the wiki, search the #Lab Help channel, and google it. If you still can't figure it out, ask!
Learning who to ask for help is another important skill. In our lab, we want you to ask questions on the #Lab Help channel. Asking questions here means (1) the whole lab can benefit from the answer and (2) we don't overburden particular lab members by asking them too many questions.
We use Todoist to manage our projects and assign tasks in our lab. The lab has three projects in Todoist: Research, Bugs, and RA Tasks. You'll be invited to these projects via email. If they do not appear when you login, click the bell icon in the upper right corner to accept the invitations.
Practice using Todoist by creating a bug! Add a task to the Bugs project Inbox with the task name [YourFirstName] is missing from the lab website. You'll work on fixing this bug in the next section.
Assign the task to yourself. Then move it to the In Progress section of the bug tracker.
See your upcoming tasks and their deadlines across all projects by pressing the
We use Github to host our lab's most important files. In this section, you'll learn to work with these files directly from the Github website. Later, you'll learn some more advanced techniques for working with these repositories.
Visit the lab's Github organization pennchildlanglab and find the repository called pennchildlanglab.github.io — that's the repository that hosts our website.
Chose a photo of yourself for our lab website. Make sure the photo is 200x200 pixels. Name the photo
Navigate to the assets folder and then the images folder
Click the Add files button and then Upload files
Add your photo file and then press the Commit changes button
Next, navigate back to the pennchildlanglab.github.io repository and select the _authors folder. Click on Add file and then Create new file.
Name your file
02 for post-docs,
03 for grad students,
04 for research assistants.
PERSONNUM: choose the next available number in your
NAME: your first name; must be the same as the figure you uploaded!
Paste the code below into the editor. Change each of the sections where:
short_name: your first name, all lower case
name: the name you want to appear on our website
Postdoc for postdocs,
Graduate Student for grad students, or
Research Assistant for research assistants.
---short_name: joanname: Joan Martinposition: Research Assistant---Joan is undergraduate at the University of Pennsylvania and a research assistant in our lab.
Change the text blurb in line 7 to be about you and then press the Commit changes button. Clicking this button creates a new pull request. Once approved, your changes will go live on the website!
We use GitBook to create our lab wiki (this website!). You can find an access link to GitBook on our Lab Passwords list, shared with you via LastPass.
In this section, you'll learn how to edit the wiki and published your changes to go live on wiki.childlanglab.com. First, read the how to guide:
Then, edit this page by adding your name to the list below:
Joan Martin, 2021-05-10
Aja Altenhof, 2021-05-25
Amy Krimm, 2021-06-08