Commit Graph

24 Commits

Author SHA1 Message Date
Mike McNeil
d4463bcb88
Delete #g-community (#9981) 2023-02-22 10:09:36 -08:00
Mike McNeil
033be67742
Define DRI (#9967)
point to
https://fleetdm.com/handbook/company/why-this-way#why-direct-responsibility

(mostly because this section is what comes up in algolia search if you
search the handbook for "DRI"-- this way there's a kind of breadcrumb to
the explanation. But always nice to unfold acronyms anyways)
2023-02-21 09:59:08 -08:00
Mike McNeil
545a383558
Friendlier (#9917)
# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-02-17 14:27:12 -06:00
Eric
4142d591f3
Website: Update <call-to-action> component and article formatting guide (#9892)
Changes:
- Changed the name of the `type` prop of the `<call-to-action>`
component to `preset`
- Updated `<call-to-action>` components in articles to use the new prop
name
- Updated the article formatting guide in the Handbook to document how
to use a `<call-to-action>` preset and added examples of our two
presets.
2023-02-16 18:13:00 -06:00
Mike McNeil
6a1a6f48c2
Adjust DRI for content style guide and add guidance about how to use fleets (#9869) 2023-02-15 23:44:55 -06:00
Jarod Reyes
f97e760ab8
Update how-to-submit-and-publish-an-article.md (#9555)
Added Jarod as the DRI for review.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-02-12 11:53:53 -08:00
Charlie Chance
bb97745d62
Charlotte chance patch 2 (#9779) 2023-02-09 11:51:59 -07:00
Eric
a5a6e3ca23
Handbook: Update <call-to-action> component example (#9507)
Changes:
- Updated the `<call-to-action>` component example in the article
formatting guide handbook page to use the correct quotation marks (`”` »
`"`)
2023-01-25 19:25:36 -06:00
Eric
a6eb31a2c0
Handbook: update markdown article formatting guide (#9444)
Changes:
- Fixed a typo in the `<call-to-action>` component example.
- Added a description meta tag
2023-01-20 16:16:01 -06:00
Mike Thomas
bb40f876dd
Updated marketing DRI in the handbook (#9017)
I spotted and updated a couple of places in the handbook that needed the VP of marketing updating.
2022-12-14 13:21:37 +09:00
Eric
2d0f33f369
Website: Add script for creating HTML email partials from Markdown articles (#7574)
* add to-html-email

* email-preview

* add build-html-email script, update .gitignore

* email preview and email-templates pages, update routes, importer and policies

* add newsletter email layout, build-html-email script, to-html-email updates

* Update .gitignore

* add newsletter emails section to growth handbook

* update scripts

* update fonts in emails

* Update README.md

* Update build-html-email.js

* update comments, add page scripts to layouts

* revert change to build-static-content

* update script

* update email layout and helper

* update handbook entry

* update template data and helper

* update email layout

* update fake data and unsubscribe link

* move added handbook section to the marketing handbook

* rename script

* update colors in unused email template

* update capitalization in helper

* view-email-preview » view-email-template-preview

* Hide emails generated from markdown if they don't exist

* update preview page

* update markdown email directory, create sample article email

* lint fixes, add target="_blank" to links in emails

* update page layouts & styles

* update sample newsletter email, code font, newsletter layout

* Update README.md

* Update view-email-template-preview.js

Co-authored-by: Tim Kern <tim@fleetdm.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-12-05 16:30:24 -06:00
Charlie Chance
e03a465a4e
handbook: removing @fleetdm in Marketing page (#8756)
https://github.com/fleetdm/confidential/issues/1780
2022-11-22 11:12:36 -06:00
Chris McGillicuddy
1aaf5cd30a
Update content-style-guide.md (#8732)
Changed sentence case example formatting.
2022-11-15 16:07:30 -06:00
Chris McGillicuddy
1d0c17ee42
Added navigation links to Brand section.md (#8693) 2022-11-11 18:01:35 -06:00
Chris McGillicuddy
e6a88553d7
Updated Fleet style guide (#8634)
* Updated Fleet style guide

Updated style guide and added it to a subpage.

* Fixed a couple of blockquote formatting issues

* removed h4 example

* Implementing Mike's revisions.md

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-11-10 17:56:27 -06:00
Charlie Chance
caefbc962e
Handbook: removed #g-brand (#8468)
#g-brand slack channel is archived. Please reach out to Mike Thomas and the digital experience / brand team in #g-marketing. Thank you!
2022-10-27 17:10:47 -06:00
Mike Thomas
155d3ef6a6
Handbook - update navigation on Marketing page (#8418)
* update navigation

## The problem

After consolidating Growth, Community, and Digital Experience (Brand) under "Marketing", the side navigation has become overwhelming and unclear what sections falls into each category.

## How to fix

Since the navigation can only display top-level sections, I propose splitting the navigation as follows:

- Marketing
- Community
- Brand
- Rituals
- Slack channels

Navigating to each of these sections will then display a content table for each, labeled "In this section" (as currently exists).

To do this, I made the following changes:

- Changed heading hierarchy throughout page
- added styling to h3 to include border-top

## Caveat

Since h2 is used to define the three categories on this page (Marketing, Community, Brand), h3 tag is now utilized to define sub-sections for each of the main categories. However, this styling is specific to the Marketing page of the handbook, and should not be applied to the other pages – which I do not know how to achieve.

* add page title to purpose, add marketing page-specific styles

Co-authored-by: Eric <eashaw@sailsjs.com>
2022-10-26 13:45:13 -05:00
Charlie Chance
83fed2d668
Handbook: Marketing page edits (#8356)
* Handbook: Marketing page edits

* Marketing pass first iteration

* Handbook: adding community support to engineering

1st iteration

* Handbook:removing community support from marketing

1st iteration

* Handbook: new section for community support

* Handbook: Marketing second pass

Added sections with section links per team. 
Ask @chris-mcgillicuddy if he wants to remove the style guide sections and editing sections on this page

Updating digital experience to brand - ask @eashaw for help with link redirects

TODO: Charlie: need to check the handbook links before merging.
2022-10-21 14:24:23 -06:00
Charlie Chance
1aef4eebeb
Handbook: delete community (#8329) 2022-10-19 17:56:36 +00:00
Chris McGillicuddy
7edce8b6ef
Consolidating style guides (#8331)
* Consolidating style guide

Several sections of the handbook have their own styles guides with redundant content. I'm consolidating that content into one central location.

* Update README.md

* Update README.md

* Update README.md
2022-10-19 09:49:41 -05:00
Charlie Chance
400ea7f88a
Handbook: Rehoming Community page under Marketing (#8316)
The Community page is now on the Marketing page, with a few edits made.
2022-10-18 20:10:31 +00:00
Charlie Chance
b4fcc0f77a
Handbook: rehoming Dig-ex page to marketing (#8315) 2022-10-18 20:09:57 +00:00
Charlie Chance
676c8d452d
Handbook: merges to marketing page (#8317)
Community merged to Marketing 

Digital experience merged to Marketing

Growth merged to Marketing
2022-10-18 20:06:31 +00:00
Charlie Chance
a2a522b8a4
Creating Marketing division of the handbook (#8275)
* Creating Marketing division of the handbook

Marketing is comprised of Community, Digital Experience, Growth, and Handbook.

* Update marketing.md

* Update and rename handbook/company/marketing.md to handbook/marketing/README.md

* Update README.md

* Rename handbook/growth/README.md to handbook/marketing/growth.md

* Rename handbook/digital-experience/README.md to handbook/marketing/digital-experience.md

* Rename handbook/digital-experience/article-formatting-guide.md to handbook/marketing/article-formatting-guide.md

* Rename handbook/digital-experience/commonly-used-terms.md to handbook/marketing/commonly-used-terms.md

* Rename handbook/digital-experience/how-to-submit-and-publish-an-article.md to handbook/marketing/how-to-submit-and-publish-an-article.md

* Rename handbook/digital-experience/markdown-guide.md to handbook/marketing/markdown-guide.md

* Rename handbook/community/README.md to handbook/marketing/community.md

* Update markdown-guide.md

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2022-10-17 21:35:06 -05:00