fix: header, typo, spacing, error links (#37)

benefits-and-perks.md

@@ -1,7 +1,7 @@
 ---
 title: Benefits & Perks
 date: 2019-02-21
-description: 
+description: Since most Dwarves Foundation employees work in Saigon, this section is written with that as the default. Some benefits don't make sense in other countries. We will try our best to provide comparable benefits and perks as it makes sense, though...
 authors:
   - han
   - duy
@@ -11,11 +11,11 @@ tags:
   - team
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: 
-type:
+type: handbook
 ---
-# Benefits & Perks
+
 Since most Dwarves Foundation employees work in Saigon, this section is written with that as the default. Some benefits don't make sense in other countries. We will try our best to provide comparable benefits and perks as it makes sense, though.
 
 ## Team Growth
@@ -55,10 +55,12 @@ You can own the company if you don't want to be just tenured employees. As part
 We usually hire, and to keep the quality bar, the Dwarves are encouraged to recommend friends that you think they match with the team. We believe your suggestions should be helpful as you have to know the person.
 
 The company will pay a referral bonus to any employee who refers an applicant to our company hired by the company to a full-time position. The bonus is only applicable once the applicant successfully becomes a full-time Dwarves and is a part of at least one project. 
+
 The referring employee must still be employed with the company when the bonus is to be given.
 
 ### Employee Profit-Sharing 
 Dwarves sometime offer 5 - 10% of its annual company profits with employees, which is distributed in shares based on tenure. Profits are distributed after the books are closed on the previous fiscal year, usually around March.
+
 This model is eligible to participate after two years of working at Dwarves Foundation. The Program does not have any set expiration date, but the company reserves the right to amend it or cancel it at any time. You forfeit your shares in the profit sharing program if you resign or are terminated from Dwarves.
 
 ### Paid Time Off
@@ -85,4 +87,4 @@ If you request further checkup, a 5-25% discount will be applied for full-time e
 ### Parental Leave
 When you welcome a new child, we encourage you to take up to 6 months leave for primary caregivers not more than 2 months before giving birth. The father is allowed up to 5 days of leave as a secondary caregiver. And if you have twins, you can take up to 10 fully paid days off. All parental leaves are at 100% base salary.
 
-These benefits only applied for full-time Dwarves who have been on-boarded for more than 6 months in advance of pregnancy (internship and probation period are omitted)
+These benefits only applied for full-time Dwarves who have been on-boarded for more than 6 months in advance of pregnancy (internship and probation period are omitted).

compliance.md

@@ -1,21 +1,21 @@
 ---
 title: How we keep things on track
 date: 2019-03-13
-description: 
+description: Building an effective company is like building good software.
 authors: 
   - han
 tags: 
   - handbook
   - employee
+  - performance
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-# How we keep things on track
 
-## Building an effective company is like building good software:
+## Building an effective company is like building good software
 - First, we define the specs.
 - Then we implement the specs.
 - After that, we test and make sure everything works correctly. So, first we need to define the specs, in this case:
@@ -34,7 +34,7 @@ How do we check if the standard is being followed?
 From the playbook, we will produce a compliance checklist:
 
 ## Compliance checklist
-Compliance checklists are being built, the very first version is stored [here](https://docs.google.com/spreadsheets/d/16HtA3skVpEdDpuJ9UEkPb5Ae_SK6IiJ5Czfl_94XqN4/edit#gid=0) which include the checklist for the **Projects** that we are running. It will be expanded to all other aspects of the company. The compliance process will be executed with the compliance plan:
+Compliance checklists are being built, the very first version is stored [here](https://memo.d.foundation/newsletter/project-compliance/) which include the checklist for the **Projects** that we are running. It will be expanded to all other aspects of the company. The compliance process will be executed with the compliance plan:
 
 ## Compliance Execution plan
 Every month, the compliance checklist will be sent out to the person in charge of the project (it would be either in parallel OR incremental based on the company state). After they have answered all of the questions in the checklist, these will be the result:

dwarves-foundation-is-you.md

@@ -1,22 +1,24 @@
 ---
 title: You are Dwarves Foundation
 date: 2019-02-21
-description: 
+description: Everyone working at Dwarves Foundation represents Dwarves Foundation.
 authors: 
   - han
 tags: 
   - handbook
   - employee
+  - team
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-## You are Dwarves Foundation
+
 Everyone working at Dwarves Foundation represents Dwarves Foundation. When a customer gets a response from Quang on support, Quang is Dwarves Foundation. When a customer reads a tweet by Huy that our systems are upgrading, Huy is Dwarves Foundation. When an engineer talks to you at a meetup, you are Dwarves Foundation. In those situations, all the other stuff we do to cultivate our best image is secondary. What’s right in front of someone in a time of need is what they’ll remember.
 
 That’s what we mean when we say marketing is everyone’s responsibility, and that it pays to spend the time to recognize that. This means avoiding the [bullshit of outage language](https://signalvnoise.com/posts/1528-the-bullshit-of-outage-language) and [bending our policies, not just lending your ears](https://signalvnoise.com/posts/3513-when-empathy-becomes-insulting). It means taking the time to get the writing right and consider how you’d feel if you were on the other side of the interaction.
+
 It also means that you’re strongly encouraged to help share your thoughts, experiences, and learnings on [Medium](https://medium.com/dwarves-foundation), our blog. 
 
 The vast majority of our customers come from word of mouth and much of that word comes from people in our audience. This is an audience we’ve been educating and entertaining for 5 years and counting, and your voice is part of us now, whether you like it or not. Tell us and our audience what you have to say.

effective-meeting.md

@@ -1,7 +1,7 @@
 ---
 title: Effective Meeting
 date: 2019-02-21
-description: 
+description: To increase flexibility in how and where employees at Dwarves work, we agree on a shared set of constraints for group work and meetings.
 authors: 
   - han
 tags: 
@@ -10,33 +10,33 @@ tags:
   - team
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-## Effective Meeting
+
 To increase flexibility in how and where employees at Dwarves work, we agree on a shared set of constraints for group work and meetings.
 
-#### Using the right Scheduling tool for meeting
+### Using the right Scheduling tool for meeting
 * For meetings that only include internal recipients, it should be scheduled on Basecamp in the correct project/team and inform the people related. If it is all-hands meeting it should be schedule on Woodlands and inform the whole company.
 * For meetings that have clients or people outside of the organization, an extra invitation should be sent out using Google Calendar
 
-#### Meetings start on time
+### Meetings start on time
 If you’re leading a meeting, it’s your responsibility to start the meeting on time. If you’re attending a meeting, you are responsible for showing up on time.
 
-#### Meetings happen in regular hours
+### Meetings happen in regular hours
 All team members should make themselves available for face-to-face meetings between 10 am - 4 pm, as long as they are scheduled at least 24 hours in advance. If a meeting needs to happen outside of these hours, the meeting organizer should schedule it a week in advance.
 
-#### Meetings should have a video option
+### Meetings should have a video option
 * If you’re hosting a meeting with a remote worker invited, it’s your responsibility to provide a video link before the meeting starts for them to join.
 * If you’re attending a meeting remotely, you should join the video call before a meeting begins. It’s your responsibility to ensure this is possible — this means being in a quiet place with a fast internet connection before the meeting starts. Calling into a meeting via phone or from a public place is unacceptable.
 * For some meetings, voice calls will be sufficient - this decision is up to the meeting organizer when they create the meeting.
 
-#### Responsiblities in the meeting
+### Responsiblities in the meeting
 * Everyone is encouraged to contribute ideas to address problems and come up with solutions
 * If you do not agree with anything in the meeting, please raise and resolve it. After the agreement comes out, we have to follow what we agreed in the meeting to execute it. The team does not accept any execution out of the agreement.
 
-#### Prerequisites for successful meetings
+### Prerequisites for successful meetings
 The following things are pre-requisites for successful group work:
 * A fast, reliable internet connection. Remote employees should make all efforts to mitigate video call lag.
 * A quiet and private (must be if the condition meets) place to take meetings. If the meeting team is sitting with other people because of the limit of office space, the others who are not invited to the meeting have to respect the meeting team, please do not join the discussion or contribute any idea. Do not babble.

engineering-ladder.md

@@ -1,7 +1,7 @@
 ---
 title: Engineering Ladder
 date: 2021-11-01
-description: 
+description: One of the biggest challenges in people management is determining whether your engineers are growing in their careers.
 authors:
   - thanh
 tags: 
@@ -10,11 +10,11 @@ tags:
 - handbook
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-# Engineering Ladder
+
 One of the biggest challenges in people management is determining whether your engineers are growing in their careers. While large companies have established career ladders, most companies sacrifice them to stay “flatter” and “more agile”. In reality, there’s no such thing as a “flat” organization—having one means that people don’t spend time talking about or thinking about levels and promotions because there are so many other things to do. However, one of the main reasons people move out is because they experience stagnation in their careers.
 
 We often talk about how to scale our organization, and how to build innovative products but it’s impossible if we cannot retain our talents and have a high standard to look for new joins. For all of those reasons, we wrote [this ladder](https://docs.google.com/spreadsheets/d/1oT2u-cZ4u7ls-V3abmBiddjaZgGTUXBncycxVkyg4Jg/edit#gid=0) to enable software engineering managers to have meaningful conversations with their direct reports about the expectations of each position and how to plan for the next level in their careers without compromising consistency in external recruiting.
@@ -29,6 +29,7 @@ The purpose of the ladder is to create a structure that would allow people to se
   - **Influence**: focus on the level of impact and influence on people, including leadership, knowledge sharing, mentoring, hiring, and onboarding.
   - **Collaboration & communication**: focus on teamwork, communication skills, asking for and giving feedback, collaborating, and documentation.
 
+    >
     > We believe that Technical and Execution are “value-adders”, while Influence and Collaboration & Communication are “value-multipliers”. An adder raises the productivity output of their team members, while a multiplier raises the productivity of those around them. As you progress through higher levels, the influence, collaboration & communication become significantly more involved.
 
 - **Career path**: give engineers a map of progress. We don’t assume that all engineers should (or want to) aspire to become managers. And leadership is not only for a senior role.

faq.md

@@ -1,7 +1,7 @@
 ---
 title: FAQ
 date: 2019-02-21
-description: 
+description: Anything about Dwarves
 authors: 
   - han
 tags: 
@@ -10,56 +10,62 @@ tags:
   - team
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-# FAQ
 
-1. How to pronounce the company name? 
+1. How to pronounce the company name? \
    Dwarf is one of the hardest words to pronounce to the non-English speaker, but that’s what made we special. Checkout [how to pronounce dwarf on YouTube](https://youtu.be/3MJ1_blsY_s) 
    **/dwɔːf/** 
    It’s like ‘đ-ô-p’ with a ‘tr’ in between -> /đ-tr-ô-p/
 
-2. Just in case people don’t get it? 
+2. Just in case people don’t get it?\
   We can give them the alias email **@d.foundation**
 
-3. Do we have a theme song? 
+3. Do we have a theme song?\
   An intern randomly suggested not an official one but a theme song in 2017 [DragonForce - Three Hammers](https://youtu.be/kVIGju-rSho) 
 
-4. One word to describe Dwarves Foundation value? 
+4. One word to describe Dwarves Foundation value?\ 
    Software Craftsmanship
 
-5. One word to describe Dwarves Foundation?
+5. One word to describe Dwarves Foundation?\
    Empower Innovation with Software Craftsmanship
 
-6. Do we have HR?
+6. Do we have HR?\
    We don’t have the HR department. We aim to build a flat and transparent organization where everything runs around the mission. The Ops team takes care of hiring and training their team members.
+
    We only have an admin to take care of the paperwork. If you have any question, you can ask your team lead or the admin.
 
-7. Which date will we receive the salary/paycheck/allowance?
+7. Which date will we receive the salary/paycheck/allowance?\
    You get the paycheck on the 1st or the 15th of the month depend on your joined day.
 
-8. How about the working hours?
+8. How about the working hours?\
   We care about the quality of the work we produce rather than the number of hours worked. However if you prefer to have a fixed schedule, we recommend to start at 8am and end at 5pm as stated in [Flexible Working Hours](benefits-and-perks.md#flexible-working-hours)
 
-9. How about the dress code? 
+9. How about the dress code?\
    We don’t really have the dress code, but everyone is expected to be well-groomed and wear clean clothing, free of holes, tears, or other signs of wear.
    Clothing with offensive or inappropriate designs or stamps is not allowed. Clothing should not be too revealing.
 
-10. Any interesting projects that we are working on? 
+10. Any interesting projects that we are working on?\
     I suppose you can go to [Fortress](fort.d.foundation) to view all of that information and if you want to join any of them, you can ask the team lead.
 
-11. How about my career path? 
+11. How about my career path?\
     You can check up the [Making a Career](making-a-career.md) section where we’ve mapped our trajectory of mastery to *six different levels*.
-12. What are we heading to this year?
+
+12. What are we heading to this year?\
     Planning is guessing. It’s why we don’t really have a business plan. However, we do have an all-hands meeting every two months that you can join and get updated.
-13. Can I work on my friend project?
+
+13. Can I work on my friend project?\
     We have a short note on this topic [Moonlighting](moonlighting.md)
-14. Where can I copy the email signature?
+
+14. Where can I copy the email signature?\
     We build a small web app for it: [sign.d.foundation](https://sign.d.foundation)
-15. How to raise an issue?
+
+15. How to raise an issue?\
     Depend on the particular circumstances, you can follow the section [Raising an Issue](how-we-work.md#raising-an-issue) or just post a pitch to Basecamp.
+
     We also have the anonymous feedback form for those who're shy. Check the Woodland HQ message board.
-16. My friend who I referred to the company has already completed her probation period and finished her first month with the company. Why have I not received my referral bonus? 
-    Our goal is to ensure that projects meet our quality standards. We may ask an engineer to join a project as a supporter at first, in order to learn the ropes under his or her mentor/lead. As soon as the engineer is ready to work on his or her own, we'll convert him or her into a full-time team member and begin charging clients for his or her billable hours. For more information, please check out [How We Hire](https://github.com/dwarvesf/handbook/blob/master/how-we-hire.md#referral).  
+
+16. My friend who I referred to the company has already completed her probation period and finished her first month with the company. Why have I not received my referral bonus?\
+   Our goal is to ensure that projects meet our quality standards. We may ask an engineer to join a project as a supporter at first, in order to learn the ropes under his or her mentor/lead. As soon as the engineer is ready to work on his or her own, we'll convert him or her into a full-time team member and begin charging clients for his or her billable hours. For more information, please check out [How We Hire](https://github.com/dwarvesf/handbook/blob/master/how-we-hire.md#referral).  

getting-started.md

@@ -1,7 +1,7 @@
 ---
 title: Getting Started
 date: 2019-02-21
-description: 
+description: Welcome onboard. Getting started at Dwarves Foundation can be overwhelming. Different roles have different expectation.
 authors: 
   - han
 tags: 
@@ -10,11 +10,10 @@ tags:
   - employee
 menu: handbook
 hide_frontmatter: true
-hide_title: true
+hide_title: false
 pinned: false
-type:
+type: handbook
 ---
-# Getting Started
 
 ## Expectation
 Welcome onboard. Getting started at Dwarves Foundation can be overwhelming. Different roles have different expectation. Get to know [who does what](who-does-what.md) to warm up. There are a lot of little details, a number of big tasks, you’re learning a new job and new coworkers, and you’re likely doing all these things while working remotely. 
@@ -96,4 +95,5 @@ Before you start,  your manager will set up a Basecamp dedicated to your on-boar
 
 ![](assets/getting-started_dwarves.webp)
 
+---
 > Next: [You are Dwarves Foundation](dwarves-foundation-is-you.md)

guides/continuing-education-allowance.md

@@ -1,20 +1,20 @@
 ---
 title: Continuing Education Allowance
 date: 2021-04-19
-description: 
+description: You will always grow by learning and playing with new and cool technologies. From books to conferences, you’ll get a yearly budget for your learning and development goals.
 authors: 
   - duy
 tags: 
   - culture
   - handbook
   - employee
-menu:
+menu: memo
 hide_frontmatter: false
 hide_title: false
 pinned: false
-type:
+type: guidelines
 ---
-# Continuing Education Allowance
+
 You will always grow by learning and playing with new and cool technologies. From books to conferences, you’ll get a yearly budget for your learning and development goals.
 
 If you’re interested in taking classes that you feel improve you professionally or personally, you have a $300 annual stipend to do so. Some people take courses directly related to their careers while taking photography lessons or learning a musical instrument. It’s up to you; the point is to learn something that you feel enriches you as a person and employee.