Commit Graph

28 Commits

Author SHA1 Message Date
Mike Thomas
1bb82ed4ae
Handbook - updated Community Slack channels (#5450)
Added #g-community Slack channel.
2022-05-02 10:25:27 +09:00
Mike Thomas
3e68425d6a
handbook-operations-section (#5286)
* handbook-operations-section

Made a couple of changes to Digital Experience rituals that I missed during my review.

• Added daily handbook PR reviews
• Moved DevRel related rituals to Community group. I think that's a more suitable home for them.

* Update brand.md

* Update community.md

Fixed up some punctuation.

* Update brand.md
2022-04-28 16:42:32 -05:00
Katheryn Satterlee
ecd155c16f
Ksatter handbook 4583 weekly doc update process (#5279)
* Add community PR guidelines

* Fix broken formatting on Community Contribution process

* Correct formatting issues

Fixed incorrect casing on headings, corrected incorrect heading indicators and moved review section out of the process flow.

* Add links to community PR process

Added links to product DRIs and community contribution guidelines

* Change Communitiy contributions > Pull requests

* formatting and typo fixes

Made some formatting and typo fixes.

* Update community.md

- Added additional information on PRs that will not be merged 
- Formatting cleanu[

* Update community.md

* Add weekly documentation update to handbook/community

* Update README.md

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.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: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-04-26 12:34:49 -05:00
Katheryn Satterlee
d827f12d4f
Add community PR guidelines (#5137)
* Add community PR guidelines

* Fix broken formatting on Community Contribution process

* Correct formatting issues

Fixed incorrect casing on headings, corrected incorrect heading indicators and moved review section out of the process flow.

* Add links to community PR process

Added links to product DRIs and community contribution guidelines

* Change Communitiy contributions > Pull requests

* formatting and typo fixes

Made some formatting and typo fixes.

* Update community.md

- Added additional information on PRs that will not be merged 
- Formatting cleanu[

* Update community.md

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/README.md

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

* Update handbook/community.md

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

* Update handbook/community.md

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

* Update handbook/community.md

* Update handbook/community.md

* Update handbook/community.md

* Update handbook/community.md

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-04-25 08:58:12 -05:00
Desmi-Dizney
64c8958859
Handbook editor pass - Community (#5132)
* Handbook editor pass - Community

All edits are recorded by line:

27 Replace: “otherwise” with “otherwise,”
36 Replace: “Website” with “website”
41 Replace: “you'll” with “you”
112 Replace: “transformed” with “transform”
116 Replace: “In the Fleet documentation, when” with “When”; Add: “in the Fleet documentation” after “section”; Replace: “underscore "".” with “underscore.”; Delete: "-"  after “hyphen”
121 Replace: “To do this, navigate” with “Navigate”
124 Replace: “in which” with “when”
132 Replace: “markdown” with “Markdown”
137 Replace: “section” with “sections in ascending order”; Delete: “in ascending order” after “value”; Replace: “markdown” with “Markdown”
140 Replace: “large” with “significant”; Replace: “the need for changing” with “changing”
149 Replace: “An image” with “Images”
150 Replace: “More” with “For doc maintainers and users, more”; Delete: “, for doc maintainers and users”
154 Replace: “Github” with “GitHub”; Replace: “Github” with “GitHub”
192 Replace: “soon” with “quickly”

* Update handbook/community.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-04-20 12:10:48 +09:00
Kelvin Oghenerhoro Omereshone
0ed463d3b2
Add initial community ritual table to the handbook (#5159)
* feat: add initial community ritual table to the handbook

* fix: retype markdown pipes and dashes

* fix: remove extra rows and columns

* fix: remove tweet ritual

* Update community.md

I made one change and moved the table up. The Slack section should always be at the bottom.

* Update community.md

I made one change. Remember, when a comma or period goes at the end of a quote it should always be inside of the quotations. This does not apply to exclamation points or question marks for the sentence outside of the quotes.

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-04-16 23:50:06 +01:00
Tim Kern
c9194eeac3
Simplified community contributions section (#4844)
* Simplified community contributions section

Simplified to 8th grade reading level from 10th+ and to 314 words from 349 words

* Update community.md

All edits are recorded by line:
197 added “,” after “change”
198 added “,” after “Also’; added “,” after “Usually”
199 added “,” after “needs”; added “a” before “changes”
200 added “,” after “Next”
206 replaced “Merges for minor documentation updates or bug fixes are usually done by the Fleet team.” with “The Fleet team usually does Merges for minor documentation updates or bug fixes”

* Revised simplified community contributions section

Added Mike and Desmi's changes

* Update community.md

All edits are recorded by line:
206 replaced “The Fleet team usually does Merges for minor documentation updates or bug fixes “ with Everyone can contribute bug fixes and improvements to the documentation, whether or not they work for Fleet.

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-04-01 14:03:49 -05:00
Mike McNeil
bad53daf60
Handbook: dedupe w/ shared explanation about Slack channels (#4869) 2022-03-29 18:41:25 -05:00
Katheryn Satterlee
723b0e2dc8
Adding Growth handbook page (#4803)
* Adding Growth handbook page

* Add context to team description

@timmy-k Added the change you requested. No need to submit a new PR!

* Update growth.md

All edits are recorded by line:
30 replaced “has been” with “is”; deleted “it needs to be“ before “deliver”; replaced “delivered’ with “deliver”; added “it” after “deliver”
41 deleted “please” before “ensure”; replaced “has been” with “is”
50 replaced “can” with “is”; deleted “be” before “used”; added “and” before “software”; replace “,” with “.” after software; replaced and with “It can”; added “monitor” before “EDR”

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-03-25 15:50:37 -05:00
Andrew Baker
06d4950a42
Handbook sponsorship process (#4624)
* Handbook sponsorship process

* Update community.md

Edits recorded by line:
241 added "to" before "expose
242 reworded to make more concise
244 deleted "," after "opportunity"
257 replaced ",." with ","

* Update community.md

* Update community.md

Fixed sentence casing and also added clarity to roles responsible for approving and signing off on sponsorships.

* Update community.md

Edits recorded by line:
244 replaced "has been" with "are"
245 added "."
249 added "."
257 replaced "have been" with "are"

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-03-21 10:25:24 -05:00
eashaw
2e4a563792
Handbook - Add markdown section (#4607)
* add markdown section

* Update community.md

* Update community.md

Edits recorded by line:
34 replaced "inline," with "in line"
58 replaced "Makrdown" with "Markdown"
63 replaced "linebreak" with "line break"; replaced "newline" with "new line"; replaced "important" with vital"; replaced "newlines" with "new lines"; deleted "," after "otherwise"
78 replaced "newline" with "new line"; replaced"linebreak" with "line break"; replaced "newline" with "new line"
85 new line added
86 ended with ":"
136 replaced “easily” with “quickly”; deleted "," after "headings"
148 deleted"be "; replaced "transformed" with "transform"
153 reworded for clarity
161 added "always" before "check"
174 added " ' ' " to "pageOrderInSection"
249 deleted "," after "issue"
257 added "," after "changes"
258 deleted " it"

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-03-15 18:59:16 -05:00
eashaw
f53e635912
add slack directory to handbook pages (#4513)
* add slack directory section and index links

* slack directory -> slack channels, update DRIs
2022-03-08 17:17:22 -06:00
Luke Heath
52db2812be
Remove Printful link (#4502) 2022-03-07 13:43:00 -06:00
Andrew Baker
8d34ffb012
Update community.md (#4414)
* Update community.md

Added to "Posting on social media as Fleet"

* Update community.md

Recorded by line:
34 deleted "to do so"
42 added "," after "drafted"
61 moved "easily"
63 reworded
81 deleted "that is"
86 replaced "in which" with "when"
102 replaced "large" with "significant"
107 replaced "a user" with "users"; added "user interface" for clarity; replaced ", but" with ". Still"
110 removed "()" from "Screenshots can get out of date quickly as UIs change."
113 removed "and beyond"; removed "that" after "make sure"
116 replaced "url" with "URL"
124 added "is" before "written"
126 corrected spelling for "specified"
154 deleted "," after "story"
158 deleted quotes around "think"
167 deleted "," after "(within 1 business day)"
174 replaced "Issue" with "issue"
177 replaced "get" with "make"; replaced "quality" with "content"
178 added "to" after "changes"
179 added "," after "Usually"
180 added "," after "customers)"
182-183 reworded to "After reviewing a PR and addressing all necessary changes any Fleet team member may merge a" 
183  reworded to "community it."
184 corrected spelling of "judgment"
185 replaced "Folks" with "Those"
191 replaced "small" with "minor"; corrected "bug fix"; deleted "," after "acceptable"
192 added (SQL) for clarity
193 shifted "the" down; added "are" before "attributed"; corrected spelling of "judgment"
210 replaced "feel" with "Feel"

* Update community.md

Updating printful link

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-03-05 04:04:15 -06:00
Luke Heath
fbd63c6210
Fix masthead avatar so that gravatar image displays (#4443) 2022-03-03 16:05:54 -06:00
Mike Thomas
455033476f
mike-t-handbook-patch (#4371)
* mike-t-handbook-patch

• Added Fleet swag process to handbook

* Update community.md

Recorded by line:
3 SUGGESTION: Was "open-core" meant to be "open-source"?
49 Reworded sentence for clarity.
51 Added quotes to "-" and "_".

Co-authored-by: Desmi-Dizney <99777687+Desmi-Dizney@users.noreply.github.com>
2022-02-28 14:52:58 -05:00
eashaw
0af5e161d0
Remove numbers from documentation filenames in Fleet repo (#4313)
* Renaming files and a lot of find and replace

* pageRank meta tags, sorting by page rank

* reranking

* removing numbers

* revert changing links that are locked to a commit

* update metatag name, uncomment github contributers

* Update basic-documentation.page.js

* revert link change

* more explicit errors, change pageOrderInSection numbers, updated sort

* Update build-static-content.js

* update comment

* update handbook link

* handbook entry

* update sort

* update changelog doc links to use fleetdm.com

* move standard query library back to old location, update links/references to location

* revert unintentional link changes

* Update handbook/community.md

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

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2022-02-23 12:17:55 -06:00
Tomas Touceda
4b9d427176
Improve documentation vulnerability pipeline (#4264)
* Improve documentation for how we do vulnerability processing

* Add mermaid diagrams

* Mermaid, next try

* Change style of once an hour node

* Improve collection diagram

* Improve readability of diagrams

* Improve flow charts

* Update broken link
2022-02-22 14:01:16 -03:00
eashaw
93b50c3787
Add support for mermaid diagrams to fleetdm.com/docs (#4288)
* Add mermaid.js, remove mermaid codeblocks from <pre> tags, styles

* add custom codeblock renderer, remove jquery unwrapping, hide mermaid blocks until fully rendered

* update comment

* layout update

* Add section to the handbook about mermaid code blocks, add mermaid styles to handbook

* Update handbook/community.md

* Update handbook/community.md

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-02-22 21:49:34 +09:00
Andrew Baker
f855e45089
Update community.md (#4065)
* Update community.md

* Update community.md
2022-02-09 15:37:27 +09:00
Mike Thomas
8a8f29ab6a
Handbook - Brand and Community update (#4044)
* Brand and community handbook update

• Re-arranged # brand section
• Added section about correct Fleet name usage
• Added link to /logos
• Updated press release boilerplate text
• Added press release boilerplate to # community section
• De-duped press release boilerplate on /logos
• Increased <p> line-height site-wide to improve readability.

* Add "Brand resources" to Readme.md

* Update handbook/brand.md

* Add bottom padding to logos page
2022-02-07 14:20:34 -06:00
Mike McNeil
4cb23ea586
move info about maintaining docs under "community" (#3998)
* move info about maintaining docs under "community"

* Update community.md

* Update README.md
2022-02-03 15:14:23 -06:00
Mike Thomas
c689062ff4
Update community.md (#3863)
re-ordered to improve the flow of topics.
2022-01-27 11:29:51 +09:00
Mike Thomas
08dac76a70
Update community.md (#3861)
• changed ownership of this section from Zach to myself.
• Removed HackerNews from our list of daily engagements with the Fleet community.
2022-01-25 09:26:38 +09:00
Andrew Baker
2a5695ebc8
Update community.md (#3748)
* Update community.md

Added new PR request to reflect Communities within the handbook.

Closed previous PR in order to direct users to MacAdmins slack #fleet channel instead of #osquery channel.

* Capitalization

Hackernews -> HackerNews

* Update handbook/community.md

I just cut out some of the fat and reduced repetition slightly for clarity.

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-01-25 08:49:54 +09:00
Mike Thomas
3b621e67ee
Update community.md (#3690)
• Changed up the header tags for styling consistency.
• Added "Posting on social media as Fleet" section.
2022-01-14 09:44:01 -06:00
Mike McNeil
dc002cf999
Update community.md (#3664) 2022-01-13 12:28:53 -06:00
Zach Wasserman
80ed980b16
Add community section to Fleet Handbook (#3455) 2021-12-31 09:31:53 -08:00