Commit b6a095d6 authored by Devin Rogozinski's avatar Devin Rogozinski Committed by Matt Pensworth
Browse files

Update file _index.md to clean up out of date info

parent b4d6f155
Loading
Loading
Loading
Loading
+0 −1
Original line number Diff line number Diff line
@@ -171,7 +171,6 @@ Use descriptive headings so that people can easily search for content.
- That said, please mix *formats* where and when appropriate in the handbook, even within a single page.
Utilizing multiple formats can be valuable, and different people may prefer certain formats over others.
- Worry only about the organization **per function and result**, not about how the page will look if you embed varying types and formats of content.
- Note: A weakness of [FAQs](/handbook/communication/#structure-content-instead-of-using-faqs) is that questions are often asked in biased or leading ways. When possible, state facts as facts.

#### Use headings liberally

+7 −107

File changed.

Preview size limit exceeded, changes collapsed.

+0 −1
Original line number Diff line number Diff line
@@ -24,7 +24,6 @@ We try to avoid the downside of maturation, because this better enables us to ac
1. We create direction pages. For example, [GitLab Direction](https://about.gitlab.com/direction/) and [Product Direction - Growth](/handbook/marketing/growth/). When folks know what they are trying to achieve, proactive direction can replace the reactive approvals that can slow things down.
1. We put expiration dates on processes or decisions that are introduced in response to immediate needs or short-term issues.
1. It's best practice to [start a discussion where possible with a Merge Request (MR)](/handbook/communication/#start-with-a-merge-request) instead of an issue. An MR is associated with a specific change that is proposed and transparent for everyone to review and openly discuss. The nature of MRs facilitate discussions around a proposed solution to a problem that is actionable. An MR is actionable, while an issue will take longer to take action on.
1. Some merge requests that involve a big decision or change tend to collect a large amount of feedback. As GitLab grows in size, it is unrealistic for a single person to respond to potentially hundreds of comments. To remain efficient in these MRs and to make it scalable, it is important for the DRI to receive a clear signal of input that is shared on the merge request. Some MRs may be marked as ["Manager Mention MRs"](/handbook/communication/#scaling-merge-requests-through-manager-mention-mrs-formerly-consolidated-mrs) by clearly designating them as such at the beginning of the MR.
1. We look for ways to measure administrative burden. This helps us to understand and mitigate the impact of bureaucracy or administration on the speed at which we can operate.
1. We explore new ways to remove constraints. These constraints can be steps, limits, or approvals. Some challenges to constraints under consideration include:
    1. Make removing constraints someone's job
+1 −2

File changed.

Preview size limit exceeded, changes collapsed.

+1 −1
Original line number Diff line number Diff line
@@ -159,7 +159,7 @@ The [Growth: Engagement](/handbook/product/categories/#engagement-group) PM is t

### Reconciliation process

The navigation proposal process attempts to balance a focus on core workflows and feature visibility, which means sometimes proposal authors may disagree with the [Growth: Engagement](/handbook/product/categories/#engagement-group) team decision. If you feel like we've struck the wrong balance, let's follow the [manager mention thread process](/handbook/communication/#scaling-merge-requests-through-manager-mention-mrs-formerly-consolidated-mrs). Add a comment to the proposal and:
The navigation proposal process attempts to balance a focus on core workflows and feature visibility, which means sometimes proposal authors may disagree with the [Growth: Engagement](/handbook/product/categories/#engagement-group) team decision. If you feel like we've struck the wrong balance, add a comment to the proposal and:

1. Summarize why the proposal was rejected and your perspective on why this decision is incorrect
1. Mention your manager and the [Growth: Engagement](/handbook/product/categories/#engagement-group) PM manager
Loading