Quick Start Guide

During BrainHack School you will be exposed to a wide variety of new tools, from collaboration tools to analysis tools. At times this might make you feel a little anxious, even a little bit imposter that you didn't know them already. Don't worry if you feel overwhelmed, we are all here to help.

If you complete the school more equipped than when you started, we will have achieved our main goal. Indeed, one of the difficulties in neuro-data science is not necessarily learning how to use a tool, but rather learning that the tool even exists, and who to get in touch with that might know how to use it. (Keep in mind that everyone knows some tools, but not all of them!)

That said, here's a little Getting Started Guide on the common tools we will use throughout the BrainHack School:


We made a bunch of GIFs because GIFs are worth 5000 words. You can see them when you click on

🌠 GIF - Click to open this useless GIF ⬇ useless GIF

Pssst: If you find typos or have tips to share, feel free to edit this document! This is an open and collective effort.

Discord

Welcome to the Brainhack School Discord server: a place for participants and instructors to discuss, network, collaborate, and share resources. Discord will be your primary communication tool throughout the 4 weeks of BHS.

We will first give some quick pointers to help you configure and use the tool in a way that works best for you.

  1. Configuring your account
  2. Notification settings
  3. Communicating with others
  4. Particularities of BrainHack School's Discord

Any question ? Ask us in the #help-general channel.

1. Configuring your account

PROFILE

When you set up your profile there are two things to bear in mind:

  • Your username – please use a name by which others will be able to identify you. Precising your prefered pronouns is encouraged.
  • Your avatar – please add a profile picture or other identifier that you’re comfortable with so that others can associate your posts with you more easily.

Official help on How to edit your profile.

🌠 GIF - To edit your profile ⬇ Edit yout profile

STATUS UPDATES

Status updates can be a useful way to let others know your availability. For example, if you’re away eating or busy geeking, you may want to let others know that you’ll be slower to respond or entirely absent from the group.

Remember that your status will be visible to everyone in the Discord server.

To update your status, click your avatar in the bottom left of the screen and select the desired status or Set a custom status. For a custom status you can select when you want your status update to be removed using the clear after dropdown. You can clear a status update at any time by clicking on your avatar and selecting Clear status.

Your status is by default managed automatically by Discord, which will update it based on your activity.

🌠 GIF - To update your status ⬇ Update your status

2. Channel and Notification settings

How use and create channels

There are text channels and voice channels. For both type, you can access the channel by clicking it name on the left pannel. Voice channels allow you to share sound, video or your screen.

The channels are grouped by categories. Categories make the navigation easier, but also allows to adapt some settings (e.g. notifications, permissions) per category. These settings can also be adapted directly per channel.

You can create new categories or channels for relevant topics (e.g. your project) and choose to make the new channel public or private. Private channels are only accessible by people you invite to the channel.

🌠 GIF - To create a new channel ⬇ Create a new channel

A note on creating channels
You are free to create as many channels as you would like. However, channels dedicated to projects should be made public (not private) so people can collaborate or help you. Also be careful not to create redundant channels.

Configure your notifications

Discord notifications are great, but they may bother you when you try to focus on your project. There are a lot of options for you to determine how and when you are informed about content – and at what level of granularity. Official help on Notification Settings.

For the overall server
  1. Click on the name of the server at the top left of the screen and select Notification Settings from the dropdown
  2. In the Notifications Settings section you have options which include:
    • Muting the whole server
    • Allow notifications for either all messages, only @mentions or no message.
    • Choose to ignore or not the @everyone and @here mentions, and to use or not push notification on mobile.
    • Override these rules for specific channels.
Channel by channel
  1. Right click the name of a channel and click Notification Settings.
    • Here you have the option to use the default server settings, notify all messages, notify only @mentions or mute the channel.
🌠 GIF - To change notification settings ⬇ Notification settings

3. Communicating with others

A FEW POINTS OF ETIQUETTE

Use reply to continue conversations
  • To refer to a previous message in your own message, you can click the arrow on the top right of the reffered message.
🌠 GIF - To reply to a message ⬇ Reply to message

Use @everyone, @here and other handles sparingly
  • If you type @everyone or @here or other general handles (@instructors) in a message that will send a notification to everyone in that channel. Please use this only for items that really do need everyone’s attention.
Respect the context of this shared space
  • We want it to be somewhere where learning can happen in a supportive, safe environment.
  • Please DO NOT take conversations out of context and copy/paste them elsewhere without the permission of all the individuals who posted.
Not all communications will be synchronous
  • While IM-based conversations can feel very immediate, please don’t feel that you have to respond to messages immediately, nor expect others to respond immediately. We’re all busy, really busy!
Message Editing & Deletion
  • You are allowed to edit your messages at any time. That means if you edit a message after someone replied to it, make it clear that you edited something if it changes the meaning of your message.

SENDING PRIVATE/DIRECT MESSAGES

It can be helpful to others when you’re sharing resources and brainstorming solutions to “work out loud” in a specific thread because then your learning becomes a future resource for others, too.

However, sometimes you want to start a private conversation. To do this you can click on someone's avatar, type your message and hit enter. Then you'll be able to find your conversation in the direct messages (DM) section your Home server.

Direct message when necessary

You may feel tempted to use DM instead of asking questions in dedicated channels. If an instructor believes others will benefit from the answer, they will probably encourage you to ask your question in the appropriate channel. If you have a question, others likely have the same one, we are all learning from each other.

That said, DM are useful to discuss privately with other people (one or many) and you don't want to flood a channel.

🌠 GIF - To make direct message ⬇ Direct message

Sending files

Yes, you can send files in text channels and in direct messages. You can either drag and drop the file or click on the + on the left side of the chat bar.

Sending code snippets

When you want to share a code snippet in a channel or to someone, it is important to keep the code formatted. Whether you need to paste an output from your terminal or some python code or anything coding-related, you have to put the code between backticks.

  • Use simple backticks for inline short code : `inline code`.
  • Use triple backticks for multiline code snippets, you have to put the triple ticks on new lines :
```
multiline
code
snippet
```

Emojis

When you click on the emoji icon in the conversation or to add a reaction, you can see custom ones we’ve added.

You can find images for things like :brainhack:, etc.

Take a look at them and feel free to add more custom emoji yourself.

4. BrainHack School Features

We have set some useful features for you.

@handles

In addition to the @everyone and @here handles, we've created a useful handle to target specific crowd. The @instructors will notify all the instructors.

Channels

Prefixes

To keep our Slack organised, we've set channel prefixes. These are self-explanatory:

PrefixePurpose
#help-For questions, assistance, and resources on a topicCreate as many as you want (e.g, #help-installation, #help-python, etc.)
#proj-For collaborating and discussing about a projectEach project will have its own public channel. Choose a clever acronym, puns are encouraged

Dedicated channels

#general: Will probably become messy once the School has started.

#announcements: You are looking for collaborators to work on your project or you want to share some good news? This is the place to do it.

#help-installation: Need help to install something ? This is the place to ask!

#help-general: Need help in general ? This is the place to ask!

#Lounge: A voice channel for casual chatting.


To be continued…

What else do you want a quick start guide on?

  • Markdown format?
  • GitHub?
  • VSC?

© BrainHackMTL - Licensed under a CC BY 4.0 license.