Guide: Staff Introduction¶
Welcome to the MousePaw Media family! We’re really excited to have you aboard. This tutorial will help you get started. If you need additional help, contact your internship supervisor.
This tutorial will also get you started as a MousePaw Media employee. Read through it in order. Watch out for…
These are things you should do now.
These are things you need to watch out for.
Our Employee Handbook outlines all the company policies, rules, and expectations for staff at MousePaw Media. You should be familiar with the latest version of these policies at all times.
We publish the latest version of the Employee Handbook at eco.mousepawmedia.com. Click Employee Handbook to view or download.
Download the latest copy of the Employee Handbook from that link, and save it to your work computer for quick reference. Read it through now.
You will be emailed whenever a new version of the Employee Handbook is published.
You must have Linux, ideally an Ubuntu-based distro (version 20.04 or later), installed on your computer. See Ubuntu Setup: Installing for instructions on installing it. If you need help, contact Jason C. McDonald.
Although we work on Linux, you may access the Staff Network via Windows, macOS, iOS (Apple) mobile devices, Android mobile devices, or BSD-based operating systems if you need to.
It is your responsibility to keep your MousePaw Media account secure! Here are some very important things to keep in mind at all times.
Never share your password with anyone. We won’t ask for it. Period.
Don’t leave your work devices unlocked and unattended.
Consider enabling full-disk encryption when you install Linux.
Use a secure password manager like Bitwarden. Never use your browser’s “save password” feature.
Add Multi-Factor Authentication (MFA) to your Phabricator and Nextcloud accounts. Instructions are included in those sections below. We strongly recommend using the Microsoft Authenticator on your mobile and/or the Authenticator app on Linux desktop.
Consider adding Multi-Factor Authentication to your Mattermost account.
Be careful clicking on unusual or disguised links in emails, even if the email looks like it’s from within the company or from a coworker. Verify URLs and SSL certificates before entering your password or other information.
If you lose a device you’ve used to access your MousePaw Media account, or which you use for MFA, contact us immediately!
If you lose access to your MousePaw Media account at any point, contact
firstname.lastname@example.org. We will work with you over video chat (for
authentication purposes) to restore access to your account.
The Staff Network consists of seven major components:
Email (webmail.mousepawmedia.com or IMAP)
We also use Jitsi Meet for regular communication.
Visit staff.mousepawmedia.com for our main staff portal, with links to everything else.
Email is hosted on Webster, and thus is unaffected by the status of Hawksnest.
Email is one of our primary ways of communicating at MousePaw Media. You have a company email address issued to you.
Be sure to check your company email every single day, and respond in a timely fashion!
You can check your email through the Roundcube or Nextcloud web clients. This is useful if you don’t want to configure an external client, or need to check your email without access to your usual device.
Roundcube is a modern web client with many useful features. It is on Webster, and thus is unaffected by Hawksnest/DevNet outages.
Go to webmail.mousepawmedia.com. Sign in using your full company email address and your password.
The first time you log in, you’ll be prompted to create your user identity. Fill in your Display Name (full name with middle initial preferred), set your Organization to
MousePaw Media, and add a default signature.
We recommend this template for your signature:
Your Name Here Position, MousePaw Media Visit Us Online: MousePawMedia.com Twitter: @mousepawmedia
That’s all! Now you can begin browsing your email.
Access your company email through the Roundcube client.
If you find yourself using Nextcloud a lot, you may prefer to use that as your email client.
Go to cloud.mousepawmedia.com. Sign in using your company username and password. Click the Email icon on the top toolbar.
Set up your signature. Click the three dots next to your email account name and click Account Settings. Under Signature, enter your signature.
Here’s the example signature:
Your Name Here Position, MousePaw Media Visit Us Online: MousePawMedia.com Twitter: @mousepawmedia
Click Save Signature.
Adjust other settings as you see fit.
Access your company email through the Nextcloud client.
You can also connect your account to an external email client, such as Thunderbird or your mobile device. Here are the server settings:
Username: (Your full company email address.)
Password: (Your company password.)
Incoming Mail: IMAP (recommended)
Incoming Mail: POP3
Outgoing Mail: SMTP
Connect your company email to an email client, such as Thunderbird, Evolution, or your smartphone.
Regular Email Tasks¶
Correspond with co-workers. Read and respond to messages in a timely fashion.
Send your check-in email on the same day each week, detailing:
What you’ve done over the past week,
What you learned over the past week,
What challenges you faced over the past week,
What you’re planning to do over the upcoming week,
The Phabricator object IDs or links for anything you’ve worked on (inline),
Any questions you have for your supervisors.
Log into your email and send an message to
email@example.com. State what day you would like your weekly
check-in email to be on.
Your check-in email is how we track your job attendance. Be sure to send it on your regular day every single week! If it is not received on time, your hours for the week might not be counted.
Kimai is where we track time. You are responsible for reporting your time every day. Each day’s time sheets are locked automatically the next morning at 10 am.
If you forget to log your time, you will NOT be reminded.
firstname.lastname@example.org if you forget, and report your time
To log your time, go to
https://time.mousepawmedia.com. Login using your
company username and password.
You will be on the My times section by default.
We recommend creating separate entries for each major task you work on. This will make it easier for you to see how you use your time.
To add time, click the large Play button in the upper-right corner of the page. Fill out the following fields:
From: select the start date and time for your entry. You may estimate the start the time if you can’t remember it.
Duration: Enter the duration in
Activity: Select the project you were working on.
Most MousePaw Media projects have an entry here. If you don’t see the one you need, use
Generaland contact your supervisor.
Researchfor general-purpose research and training.
Generalfor meetings, internship assignments, and anything not covered by another category.
DevOps/ITfor repository master, build system, and server work.
Operationsfor management, administrative, and standards board tasks.
Hiringfor hiring-related tasks.
Description: You must include appropriate Phabricator object codes, including Maniphest Tasks, Differential Revisions, Calendar Events, Ponder Questions, wiki pages, and the like.
These notes are not a replacement for your check-in email.
Finally, click Save in the lower-left corner to store the hours.
While you’re here, take a look at the Dashboard, Calendar and Reporting tabs. These give you detailed breakdowns of your hours, including what you worked on and when you worked.
If you need a tool to help you track your time, check out the Timecard application, created by Jason C. McDonald.
Regular Kimai Tasks¶
Log your hours every day you work.
Seriously, that’s it. Log your time!
Phabricator is where most of our development work takes place. It hosts our repositories, task tracker, knowledge base, and wiki.
To get the most out of Phabricator, you should adjust some settings and fill out your profile. Follow these instructions…
Log into Phabricator using your company (LDAP) credentials.
Click your profile picture in the upper-right corner.
On that page, click Manage and Edit Profile.
Fill out as much of the profile as you want/can. Have fun with this!
Please fill out at least five “Fun Stuff” fields, as this is what we will use to craft your profile on the MousePaw Media website.
Click Save Profile at the bottom.
Click Edit Settings at right. Alternatively, click your icon picture at the top of the page and select Settings.
Select Account at left, and set Pronoun appropriately. Click Save Changes.
Click Notifications at left. Select the option
Web and Desktop, and save. Then, click Enable Desktop Notifications. You may consider clicking Send Test Notification in the upper-right corner to test. Then, click Save Preference.
- Click External Accounts at left. Add your GitHub account.
Click Save Changes.
You should also add your company email address to your GitHub account, so you can get public credit for your contributions to our repositories.
We strongly recommend adding Multi-Factor Autentication to your Phabricator account. Click Multi-Factor Auth at left. On your mobile device, install a trustworthy authenticator app like Microsoft Authenticator. On your work laptop, you can install Authenticator. ONLY USE ONE! (Using both requires both.) On Phabricator, click Add Auth Factor. Follow the instructions to link your authenticator app. Repeat for the other app.
Click Email Preferences at left. Here, you may shut off many
email notifications by selecting the Notify option for any given item. Recommended defaults are provided, but you can adjust these to your needs.
Do NOT select “Ignore” for any notifications! All notifications are ultimately controlled by whether you’re “Subscribed” to an object.
Take a few minutes to go through the rest of the settings independently. Use the menu at left to see more settings.
Click Phabricator in the upper-left corner to return to the main page.
Regular Phabricator Tasks¶
Phabricator is MASSIVE, so which apps you use depend heavily on what you’re doing. There are six major apps you should be making frequent use of.
Read ‘The Check-In’ every week. You’ll find reminders, company news, helpful tips, and Jason McDonald’s “Useless Trivia of the Week”.
Calendar (see Calendar)
RSVP for all events you’re invited to.
Create events you’re organizing.
Maniphest (see Maniphest)
Create and manage tasks for everything you’re working on.
Report bugs and request features.
Phriction (see Phriction)
Monitor pages for projects you’re involved in.
Maintain any specs and design notes you’re responsible for.
Learn and share knowledge, especially via the Resources section.
Ponder (see Ponder)
Store collected information as you research a problem.
Help answer other people’s questions.
Differential (see Differential)
Submit and maintain Revisions for your code revisions.
Review other people’s Revisions.
Pholio (see Pholio)
Submit and maintain Mocks for your graphical work.
Review other people’s Mocks.
All of these apps (and more) are on the left side of the main page of Phabricator.
We use Mattermost, an open source chat service, for team chat. All staff members are expected to be logged into Mattermost during work, and are strongly encouraged to stay signed in when convenient to facilitate collaboration and communication.
Mattermost can be accessed directly through the web browser from chat.mousepawmedia.com, but we strongly recommend installing the official client, which works on Linux, Windows, macOS, Android, and iOS. You can download and install the client from mattermost.com/download.
Install the Mattermost client on your work computer, and if possible, on your mobile device.
Creating Your Account¶
Mattermost is the only service we use which is not tied to your MousePaw ID. Instead, you’ll need to create an account using the invite that was sent to your MousePaw Media email address. You must sign up using your company email address, or else you will be unable to access our chatrooms.
Sign up using the invite that was emailed to your company email address.
Once you’ve signed in to Mattermost, either through the website or the client, you should immediately set up your user profile. Click your profile picture in the upper-left corner and click Account Settings. Add your Full Name, your Profile Picture, and anything else you want to add.
Log into the MousePaw Media Mattermost and set up your user profile with your Full Name and Profile Picture.
At this time, you may want to take a minute and look through the other Account Settings, especially…
Security: Multi-factor Authentication
Notifications: Email Notifications
Rooms in Mattermost¶
When you log in for the first time, you’ll be added to the most important rooms. There may be more that you can find and join freely later.
Here’s the most important rooms for you to join and know:
Town Square (
~town-square) is our public room, linked to our IRC
channel. Please default to using this room for any development conversations,
so anyone joining via IRC can see and join in.
Because Town Square is bridged to IRC, deleting a message will not actually delete it from the room history altogether. What you say, you cannot take back.
Water Cooler (
~water-cooler) is our staff-only chatroom. Use this for
any internal conversations that we don’t want to have in public.
Off Topic (
~off-topic) is for random chat-chat that doesn’t really
relate to work.
~eco) is for any questions you want to bring up with ECO, but
which you don’t necessary need to keep confidential from other staff.
(If you want a private conversation, feel free to email
~it) is for reporting any problems with the staff network,
Last, but not least, you can private message anyone through Mattermost.
Post a message in
Nextcloud allows us to share and collaboratively edit documents.
When you first log into Nextcloud, click your username in the upper-right corner and select Settings. This will take you to your profile and settings screen. Fill out your profile.
At left, select Security. Start by saving your backup codes in case you lose your device. Then, enable both Nextcloud Notification and Enable TOTP. That last one will walk you through linking to one Authenticator app; we recomemend Microsoft Authenticator on your mobile device. If you don’t have a mobile, use Authenticator on your Linux machine.
The Activity section allows you to customize notifications. We recommend leaving many Push notifications enabled.
If you’ll be using Nextcloud regularly, you may consider setting up the Nextcloud Client on your computer. See Installing Nextcloud Client.
Regular Nextcloud Tasks¶
Nextcloud is where we store all important staff documents (see ECO: Employee Care and Opportunity), and where we share a lot of common non-code files.
If you work in the Design+Production or Content Development departments, you’ll especially be spending a lot of time on Nextcloud.
Review and proofread files. (Content Development)
Collaborate on documents. (Content Development)
When you upload files, be sure to place them in an appropriate folder and share the folder with your department.
ECO: Employee Care and Opportunity¶
Our “human resources” department is called ECO, which stands for Employee Care and Opportunity.
All the ECO forms you’ll need are stored on Nextcloud, in the ECO folder.
All forms must be filled out, signed by hand, scanned in (see sidebar),
and emailed to
Formal Grievance: If you are unable to resolve a conflict with a co-worker via informal discussions, you may file this form within 15 days of the most recent incident.
Promotion Request: When you are ready to be promoted to Intern II, to graduate from the internship program, or otherwise be promoted to a higher seniority, you must fill out and submit this form. Interns will also need the appropriate Internship Checklist.
Leave of Absence Request: Any time you will be absent for a week or more, or under six hours a week in the case of an intern, you must file this request at least two days before your absence!
Resignation Request: If you choose to leave MousePaw Media, you must file a resignation request. If you’re an intern, we may choose to terminate your employment with us instead of accepting the resignation, as specified in your contract.
There are a few more ECO forms which are accessible only to management.
Hiring Checklist: When we are reviewing an applicant for our internship program, we use this form to collect and track all the relevant information about them.
Employee Disciplinary Warning Notice: For serious and/or recurring problems, a supervisor may detail the incident and the expected remedy using this form. If you receive one, be sure to read it, initial and sign it, and send it back via e-mail ASAP.
Employee Termination: In the rare and unfortunate case where an employee must be fired, we use this form. There is also a separate Internship Termination form.
Previous MousePaw Media graduates have written up some tips for new interns! You can read those on the Phabricator Phriction wiki at the link below:
Read Internship Tips
You can learn more about the different parts of the Staff Network in the other sections of this documentation.
If you’re an intern, you can find a list of all your assignments on the appropriate Internship Checklist at the bottom of the Assignments Phriction page.
Programmers should check out these sections next:
Content Developers should check out this section next:
Design+Production and Mass Communication staff should check out this section next: