1. Accessing lab resources

Learn to access the tools you'll need to work in the lab

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

Step 1: Twist

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.

Create a thread

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!

Suggestions for introduction: Tell us who you are, where you are from, why you are joining the lab (i.e. summer program, independent study, etc), maybe a fun fact about you, what you like doing for fun, and/or anything else you want us to know about you!

Use Quick Chat

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!

Send a private message

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.

Ask for help

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.

Step 2: Todoist

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.

Where to find project invitations in todoist

Create a task

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 a task

Assign the task to yourself. Then move it to the In Progress section of the bug tracker.

View all tasks

See your upcoming tasks and their deadlines across all projects by pressing the Upcoming button.

See what's on your plate this week with the Upcoming button

Step 3: Github

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.

Use the #Lab Help channel on Twist to request access to this repo if you haven't already.

Add your photo

  1. Chose a photo of yourself for our lab website. Make sure the photo is 200x200 pixels (see this website if you need help cropping your image to a square and changing the size)

  2. Name the photo yourname.png; this part is important or your picture might not show up on the website.

  3. Navigate to the assets folder and then the images folder

  4. Click the Add files button and then Upload files

  5. Add your photo file and then press the Commit changes button

Navigate to the images folder inside the assets folder to upload your picture

Add your author page

Next, navigate back to the pennchildlanglab.github.io repository and select the _authors folder. Click on Add file and then Create new file.

Create a new file

Name your file JOBNUM_PERSONNUM_NAME.md where:

  • JOBNUM: 02 for post-docs, 03 for grad students, 04 for research assistants.

  • PERSONNUM: choose the next available number in your JOBNUM group.

  • NAME: your first name; must be the same as the figure you uploaded!

Name your file according to the naming convention

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

  • position: Postdoc for postdocs, Graduate Student for grad students, or Research Assistant for research assistants.

---
short_name: joan
name: Joan Martin
position: 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!

Don't forget to complete the task you added to the bug tracker on todoist once you are added to the website!

Step 4: GitBook

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.

If you haven't received the passwords list, ask Ariel to send it to you!

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

  • Tula Childs, 2021-6-14

  • Katarina Siggelkow, 2021-06-16

  • Cynthia Gu, 2021-06-21

  • Lauren Kim, 2021-08-03

  • Gwen Hildebrandt, 2021-09-15

Hooray! You've finished part 1 of the Onboarding Tutorial