Commit Graph

619 Commits

Author SHA1 Message Date
Luke Heath
d9f903f496
Modify engineering meeting DRI description (#7150) 2022-08-17 16:55:07 -05:00
Mike McNeil
82f722ee97
Handbook: Remove argument from authority, use more objective language (#7266)
* Handbook: Remove argument from authority, use more objective language

* Copy/paste fix

* Add link to becoming a contributor

* Accuracy
2022-08-17 03:00:27 -05:00
Nathanael Holliday
953d03ef4f
Sales handbook update (#7219)
* Sales handbook update

Quick updates to Sales page in handbook defining Salesforce lead statuses.

* Update README.md

Co-authored-by: Alex Mitchell <105945793+alexmitchelliii@users.noreply.github.com>
2022-08-16 12:50:22 -05:00
Mike McNeil
080723dde7
Handbook: Add links to SOC 2 and trust reports, and to security handbook (#7159) 2022-08-15 12:35:24 -05:00
Andrew Baker
8c6e93be08
Update Swag request process (#6992) 2022-08-15 10:10:44 -05:00
Chris McGillicuddy
8c0f35d264
Adding a video to the Fleet docs (#7081)
* Adding a video to the Fleet docs

These instructions make sure embedded YouTube videos display correctly on mobile.

* Add files via upload

- uploaded video embed guide gif

* Update handbook/community/README.md

- added a gif to show how to find the YouTube video embed URL

* Updated image link in community/README.md

updated image link

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
2022-08-15 09:01:11 -05:00
Charlie Chance
d728189dd5
Handbook: calendar audit ritual (#7192) 2022-08-12 15:51:43 -06:00
Alex Mitchell
f642e3e7b9
Update README.md (#7185)
* Update README.md

Added a ritual for lead pipeline review and a link to the overview video on YouTube.

* Update handbook/sales/README.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-08-12 16:28:36 -05:00
Mike McNeil
fb997907df
Handbook: Update positioning canvas link (#7188) 2022-08-12 11:11:10 -05:00
Zach Wasserman
640a1f3192
Add coworking reimbursement information (#7133) 2022-08-11 08:28:18 -07:00
Mike McNeil
69fb9ad026
Handbook: Add link re: working at Fleet (#7146)
This page is linked to from hiring materials, which don't always make the "open source is forever" point.  This adds a link to accomplish that, for folks who are really digging in.
2022-08-10 10:25:09 -05:00
Eric
0811946a84
Website: update Markdown blockquotes (#7046)
* Add blockquote styles, to-html.js updates

* test article *REVERT THIS COMMIT BEFORE MERGE*

* Revert "test article *REVERT THIS COMMIT BEFORE MERGE*"

This reverts commit 3192bdbf753894c354146048df24ebeb30cdc3bc.

* to-html comments & update variable names

* Update to-html.js

* add new blockquote styles to docs and handbook pages

* update purpose name & stylesheets

* wrap blockquoteHtml in divs, add examples to markdown guide

* lint fix

* update quote and large quote blocksquotes usage, revert *most* to-html changes

* lint fixes
2022-08-05 16:15:46 +09:00
Noah Talerman
7ad0667b6a
Add DRIs for release testing (#6804)
- Add DRIs for release testing
- Add DRIs for patch release testing
- Update patch release playbook
2022-08-04 12:23:19 -04:00
Mike Thomas
7cb54728a3
Update how-to-submit-and-publish-an-article.md (#7049)
* Update how-to-submit-and-publish-an-article.md

- updated broken anchor link

* Update how-to-submit-and-publish-an-article.md

- updated instructions in the "Who can publish articles?" section.
- added links to our Markdown guide.

* Update handbook/digital-experience/how-to-submit-and-publish-an-article.md
2022-08-04 18:08:22 +09:00
Mike Thomas
8216d2be98
Handbook - Digital Experience housekeeping (#7048)
README:
- fixed broken link for "how to submit and publish an article

How to submit and publish an article:
- added links to "Article formatting guide" and "Markdown guide"

Article formatting guide:
- added link to Markdown guide
2022-08-04 15:37:29 +09:00
Mike Thomas
cbc4565b57
Markdown guide for the handbook (#6864)
* Markdown guide for the handbook

Markdown guide for the handbook.

* Update markdown-guide.md

* Update markdown-guide.md

* Update markdown-guide.md

* Update markdown-guide.md

* Update markdown-guide.md

* Update handbook/digital-experience/README.md

* Update handbook/digital-experience/markdown-guide.md

* Handbook - Re-ordered Digital Experience README.md

- I repositioned Markdown to be under Voice and tone.
@Desmi-Dizney, I think you are right. Including the Markdown section under the section for writers is better.

* Update markdown-guide.md

- actioned review comments (https://github.com/fleetdm/fleet/pull/6864#pullrequestreview-1053545929)
- reformatted the markdown guide.
- updated nested list examples to display inside a table
- removed a couple of link examples that don't currently render on the website

* Update README.md

- I removed the Markdown section. I'd prefer to link to this guide as and when it's needed.

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-08-04 11:45:44 +09:00
Eric
bb3d4e0096
Handbook: Update link to positioning deck (#7041) 2022-08-03 20:27:06 -05:00
Mike Thomas
392872d67c
Handbook - add article submission process (#6936)
* add article submission process

- added process-for-submitting-and-publishing-articles.md
- renamed article-formatting-guide.md
- updated links on README.md

* add anchor links

- add anchor links

* formatting changes and link fixes

- Changed up some formatting and fixed a couple of broken anchor links.

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/digital-experience/process-for-submitting-and-publishing-articles.md

* Update process-for-submitting-and-publishing-articles.md

- changed the title meta tag to lowercase.

* title update

- updated the page title in response to https://github.com/fleetdm/fleet/pull/7021
- fixed up some internal links to related pages

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-08-04 08:32:24 +09:00
Alex Mitchell
abd487b244
Updated link to latest deck with latest positioning. (#6996) 2022-08-01 22:50:16 -05:00
Mike Thomas
26d763c426
Updated testing.md (#6583)
* Updated testing.md

Updated the name of testing.md to testing-and-local-development.md based off https://github.com/fleetdm/fleet/issues/4706

* add redirect for /docs/contributing/testing

Co-authored-by: Eric <eashaw@sailsjs.com>
2022-08-01 19:06:30 -05:00
Desmi-Dizney
d9935f72d6
Editor pass - Update customers.md (#6887)
Editor pass for:
-  https://github.com/fleetdm/fleet/pull/6546
2022-08-01 11:02:27 -05:00
Charlie Chance
96ce229435
Handbook: Payroll procedures (#6978) 2022-07-29 14:12:32 -06:00
Zach Wasserman
c6c404832c
Update oncall responsibilities (#6757)
* Update oncall responsibilities

* Update engineering.md

* Update engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

* Update handbook/engineering.md

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
Co-authored-by: Desmi-Dizney <desmi@fleetdm.com>
2022-07-28 13:24:50 -05:00
Mike Thomas
52e22014a9
re-organized digital experience handbook page (#6933)
- moved Article formatting guidelines to their own page
- moved glossary of terms to its own page
2022-07-28 16:33:49 +09:00
Nathanael Holliday
24c02a06f4
DRI update for Slack channel (#6930)
* DRI update for Slack channel

Deleted Eric from the DRI list for digital experience slack channel.

* Update handbook/digital-experience/README.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-07-28 10:02:10 +09:00
Desmi-Dizney
4759839502
Enclosed HTML comment (#6921)
As per @mikermcneil's Slack request.
- https://fleetdm.slack.com/archives/C01GQUZ91TN/p1658829817317569
2022-07-27 17:31:18 -05:00
Desmi-Dizney
3460aaaa9b
Renamed Brand to be Digital experience (#6884)
* Renamed Brand to be Digital experience

@eashaw and I changed this to be titled Digital experience.

* Capitalized Digital Experience in handbook/digital-experience/README.md

* Capitalized Digital Experience in handbook/digital-experience/README.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-07-27 16:18:51 +09:00
Desmi-Dizney
a548fb771e
Updated Slack channel for Operations (#6899)
Done as per @mikermcneil's request in Slack 

mikermcneil
@Desmi Dizney
  can you update this slack channel in the relevant handbook to reflect this? https://fleetdm.slack.com/archives/C03MMC90MNU/p1658798689913439
mikermcneil
has renamed the channel from "help-operations" to "help-operations-and-contract-reviews"
2022-07-27 01:47:41 -05:00
Eric
1200a5fc6f
Website: Add support for multiple levels in the handbook (#6524)
* Website: add support for excludePageFromSectionIndex meta tag in Markdown content

* revert articles and docs changes

* move handbook pages into subfolders, rename brand to digital experience, update links

* update page script, add pages in same section to generated index

* remove newline

* add redirect for renamed handbook page (/handbook/brand -> /handbook/digital-experience)

* handbook: update relative page links

* update comment

* Update basic-handbook.page.js

* Revert .sailsrc change

* Update basic-handbook.ejs

* Update basic-handbook.page.js

* Update basic-handbook.page.js

* Update security.md

I added an example of how second-level sections could be introduced (linked to).

* update links on security.md, remove related pages

* change top level files filenames to README.md

* remove handbookSection

* Update basic-handbook.page.js

* only include top level pages in handbook index

* update relative links

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2022-07-25 11:18:58 -05:00
Mike Thomas
546543c361
Handbook – updated Sales team writing principles (#6792)
* Update sales.md

- I renamed the writing principles section. The previous version was a bit of a tongue-twister for me :)
- I broke the principles into subheadings to make the section more scalable. We may need to add more principles later.

* Update sales.md

- I added an intro to the section
2022-07-22 13:26:24 +09:00
Nathanael Holliday
c37d924e78
Update brand.md (#6784) 2022-07-22 13:25:56 +09:00
Desmi-Dizney
cda1e34989
Added ritual of updating the "Release" field in the #g-growth board (#6743)
This was added as per:
- https://github.com/fleetdm/fleet/issues/6739
2022-07-21 10:34:25 -05:00
Tony Gauda
cf1787c116
Update customers.md (#6546)
Adding DRI change process
2022-07-21 10:00:28 -04:00
Mike Thomas
43197b2f77
Update brand.md (#6795)
Updated broken image link
2022-07-21 14:33:47 +09:00
Desmi-Dizney
4a28975435
Article formatting guidelines (#6668)
* Article formatting guidelines

Created as per https://github.com/fleetdm/fleet/issues/6570

* Update handbook/brand.md

* Added custom CTA image examples for handbook

Added images for instructions about how to use the custom CTA for articles.

* Updated Article for formatting guide on brand.md

I made some markdown and formatting fixes with Des.

* update relative image links

* Update handbook/brand.md

added context for what the meta tags are for when writing articles.

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>

* Update handbook/brand.md

Added clearer instructions for where to create a new file for an article.

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Eric <eashaw@sailsjs.com>
2022-07-21 14:17:59 +09:00
Mike Thomas
7e15924ad7
Handbook - removed <br/> from Growth.md (#6793)
I removed the <br> tag from the Rituals table.

FYI @Desmi-Dizney, nice idea to try to break up these sentences, but <br> should be avoided, in part because they become unruly at different browser sizes and cause ugly gaps in paragraphs. In this case it was forcing a [widow](https://www.fonts.com/content/learning/fontology/level-2/text-typography/rags-widows-orphans).
2022-07-21 00:08:59 -05:00
Desmi-Dizney
a1d917a5d2
Updated OOO handoff process (#6712)
* Updated OOO handoff process

# This is created as per:
- https://github.com/fleetdm/confidential/issues/1517

## @CharlotteChance's notes for reference:

Handbook in People

Rough draft:

- Communicate what the responsibilities are when performing a handoff
- Communicate when and how long (setting expectations)
- Communicate who they should go to if they need help satisfying those responsibilities
- If time does not allow for this (i.e. family emergency, dramatic illness), call in help from your manager for assistance in the handoff


# I made updates to the Taking time off section.
I'm requesting @chris-mcgillicuddy's review.

* Update handbook/people.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/people.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

Co-authored-by: Charlie Chance <100798688+CharlotteChance@users.noreply.github.com>
Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-07-20 18:32:05 -05:00
Mike Thomas
3c17fd8106
Handbook brand patch mike t (#6758)
* Fixed bad links on brand.md

- Fixed up some bad links that were pointing to localhost.

* fixed broken links on brand.md

- Fixed a couple more bad links
2022-07-20 16:56:47 -05:00
Desmi-Dizney
82d395e239
Checking Twitter messages ritual (#6693)
* Checking Twitter messages ritual

Created as per: https://github.com/fleetdm/fleet/issues/6692

* Added Drew Baker as Twitter messages DRI

Co-authored-by: Tim Kern <tim@fleetdm.com>
2022-07-19 10:04:39 -05:00
Mike Thomas
dfe090edd4
Update community.md (#6733)
Added, "How to request a review for Markdown changes to docs."
2022-07-18 17:54:30 -05:00
Desmi-Dizney
f4dcd73fed
OKR - Changed docs markdown editing process (#6713)
* OKR - Changed docs markdown editing process

Tagging @mike-j-thomas for review.

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update handbook/brand.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>

* Update community.md

* Update brand.md

* Update customers.md

* Update community.md

* Update brand.md

@mike-j-thomas, should Docs (REST API) be changed as well?

* Update brand.md

* Update handbook/community.md

* Update handbook/customers.md

* Update handbook/community.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-07-18 14:39:15 -05:00
Desmi-Dizney
521fa4f285
Added "Writing for the Sales team" (#6696)
* Added "Writing for the Sales team"

Created as per: https://github.com/fleetdm/fleet/issues/6671

@alexmitchelliii, this can be moved wherever you like. Let me know if you need any more help.

@mikermcneil, does this count as 5 sentences? 😂

* Update sales.md

* Update handbook/sales.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update handbook/sales.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-07-17 20:52:23 -05:00
Desmi-Dizney
3329bc0a7c
Editor pass - handbook: relocate CEO shadow program (#6677)
Editor pass for:
-  https://github.com/fleetdm/fleet/pull/6653
2022-07-14 17:26:45 -05:00
Desmi-Dizney
2b85a97e5c
Editor pass - In Product handbook, add "epic" DRI (#6676)
Editor pass for:
-  https://github.com/fleetdm/fleet/pull/6643
2022-07-14 17:16:49 -05:00
Mo Zhu
9dc5ffbf7f
Handbook - Reflect Mo is now PM for platform (#6663) 2022-07-14 13:21:08 -06:00
Mike McNeil
305688a327
fix broken link (#6660) 2022-07-14 11:30:17 -05:00
Charlie Chance
149d3f7196
handbook: relocate CEO shadow program (#6653) 2022-07-13 17:50:17 -06:00
Desmi-Dizney
43b0ca4189
Added glossary (first draft) (#6482)
* Added glossary (first draft)

@mike-j-thomas, This is my first crack at building a table. I think I got it right but I'm open to feedback.

* Update brand.md

- I moved the position of the glossary to the end of the "writing at Fleet" section.

* second look

I took a second look at this for capitalization. 

It's ready for your eyes @mike-j-thomas.

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update handbook/brand.md

Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>

* Update brand.md

* Update handbook/brand.md

* Update handbook/brand.md

* Update brand.md

* Apply suggestions from code review

Commiting the latest @Desmi-Dizney suggestion

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Guillaume Ross <guillaume@fleetdm.com>
2022-07-13 18:41:14 -05:00
Charlie Chance
1e78903c29
Handbook: payroll edits (#6652) 2022-07-13 16:38:56 -06:00
Noah Talerman
75b956bcb9
In Product handbook, add "epic" DRI (#6643) 2022-07-13 11:30:30 -05:00