From 40527af670900af4ea380f58c04cbeedc5245154 Mon Sep 17 00:00:00 2001 From: eashaw Date: Thu, 4 Nov 2021 22:11:44 -0500 Subject: [PATCH] Add DRI section to the Fleet handbook (#2800) * table styles for handbook * Update product.md * Update product.md * Update product.md * update readme links * move dri section, update readme links * Update product.md * requested changes * moved dri section to people, updated readme links, moved table of product DRIs * Update handbook/product.md * Update handbook/product.md * Update README.md Co-authored-by: Mike McNeil Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com> --- handbook/README.md | 6 ++++- handbook/people.md | 9 ++++++++ handbook/product.md | 22 ++++++++++++++++++- .../styles/pages/handbook/basic-handbook.less | 20 +++++++++++++++++ 4 files changed, 55 insertions(+), 2 deletions(-) diff --git a/handbook/README.md b/handbook/README.md index d736461494..5c1a758bb3 100644 --- a/handbook/README.md +++ b/handbook/README.md @@ -14,19 +14,23 @@ The Fleet handbook is the central guide for how we run the company. As part of o ### People +[Directly responsible individuals](./people.md#directly-resonsible-individuals) + [Spending company money](./people.md#spending-company-money) [Meetings](./people.md#meetings) ### Product +[Product DRIs](./product.md#product-dris) + [Fleet docs](./product.md#fleet-docs) [Manual QA](./product.md#manual-qa) [Release process](./product.md#release-process) -[Support process](./product.md#release-process) +[Support process](./product.md#support-process) [UI design](./product.md#ui-design) diff --git a/handbook/people.md b/handbook/people.md index ca3b7b38d4..fc263c03b4 100644 --- a/handbook/people.md +++ b/handbook/people.md @@ -1,3 +1,12 @@ +## Directly responsible individuals + +At Fleet we use the concept of directly responsible individuals (**DRI**s), a person who is singularly responsible for a given aspect of the open source project, the product, or the company. + +This person is responsible for accomplishing goals and making decisions about a particular aspect of Fleet. + +DRIs help us collaborate efficiently by knowing exactly who is responsible, and can make decisions about the work they're doing. + +>You can read more about directly responsible individuals in [Gitlab's handbook](https://about.gitlab.com/handbook/people-group/directly-responsible-individuals/) ## Spending company money As we continue to expand our own company policies, we use [GitLab's open expense policy](https://about.gitlab.com/handbook/spending-company-money/) as a guide for company spending. diff --git a/handbook/product.md b/handbook/product.md index 4018f69a68..ebe72519dc 100644 --- a/handbook/product.md +++ b/handbook/product.md @@ -1,3 +1,24 @@ +## Product DRIs + +Below is a table of [directly responsible individuals (DRIs)](./people.md#directly-resonsible-individuals) for aspects of the Fleet product: + +| Aspect | DRI | +| ------------------------------------------------------------- | ------------- | +| Wireframes (figma) | Noah Talerman | +| How the product works | Noah Talerman | +| fleetctl CLI interface (and other tools) | Tomás Touceda | +| REST API interface, REST API docs | Luke Heath | +| Terraform, Postman | Ben Edwards | +| Customer deployments like expedia.fleetdm.com | Ben Edwards | +| dogfood.fleetdm.com | Ben Edwards | +| Quality of core product UI | Luke Heath | +| Quality of tickets after Noah's done with them | Luke Heath | +| Quality of core product API | Tomás Touceda | +| Quality of fleetctl (and other tools) | Tomás Touceda | +| Final cut of what goes into each release | Zach Wasserman| +| When we cut a release, version numbers, and whether to release| Zach Wasserman| +| Release notes | Noah Talerman | +| Publishing release blog post, and promoting releases | Mike Thomas | ## Fleet docs @@ -361,6 +382,5 @@ We have certain design conventions that we include in Fleet. We will document mo Use `---`, with color `$ui-fleet-black-50` as the default UI for empty columns. - diff --git a/website/assets/styles/pages/handbook/basic-handbook.less b/website/assets/styles/pages/handbook/basic-handbook.less index abf547d036..4351a48766 100644 --- a/website/assets/styles/pages/handbook/basic-handbook.less +++ b/website/assets/styles/pages/handbook/basic-handbook.less @@ -222,6 +222,26 @@ margin: 16px 0px 40px; } } + table { + border: 1px solid @border-lt-gray; + border-collapse: collapse; + font-size: 16px; + line-height: 24px; + margin-bottom: 16px; + + th { + font-weight: @bold; + font-family: @header-font; + border: 1px solid @border-lt-gray; + padding: 8px 7px 7px 8px; + } + + td { + font-family: @main-font; + border: 1px solid @border-lt-gray; + padding: 8px 7px 7px 8px; + } + } }