Commit Graph

114 Commits

Author SHA1 Message Date
Sam Pfluger
46334d1bf5
#g-ceo to g#digital-experience (#16445)
...

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2024-01-30 16:58:09 -06:00
Eric
43f21baa86
Website: Update script to create GH issues for rituals in YAML files. (#15752)
Closes: #14246

Changes: 
- Added a new key to the rituals YAML configuration: `autoIssue.repo`.
This value should be a string that is the name of the GH repo that
issues for the ritual should be created in.
- Updated ritual validation in `build-static-content`.
- Added support for the "monthly" ritual frequency for rituals with an
`autoIssue` value.
- Updated the `create-issues-for-todays-rituals` script to create GitHub
issues for rituals.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2024-01-15 12:53:53 -06:00
Sam Pfluger
112c2d0f43
Handbook: remove bugs board link from "Contact us" section (#16058)
Removed "🪲 Bugs board" link from "Contact us" section and added links to
product group kanban boards.
2024-01-12 10:12:21 -06:00
Luke Heath
57aa09521c
Update postmortem documentation (#16033)
We will begin conducting postmortems for critical bugs in addition to
outages.

1. How was the bug introduced?
2. What is the gap in our testing process that we didn't find the bug
before it was released?
3. How are we going to change our testing (both manual and automated) so
that we will catch a similar bug in the future?

Why? We want to start evaluating the three questions above for every
critical bug so that we can learn and improve our processes.
2024-01-10 20:15:42 -06:00
Noah Talerman
5f38355169
Merge fleetd doc page to enroll hosts page (#15907)
- Move relevant content from "Fleetd" doc page to "Enroll hosts" page
- Remove "Fleetd" docs page
2024-01-10 14:35:18 -05:00
Sam Pfluger
b2899c402e
Handbook/company/leadership#structure-of-departmental-handbook-pages (#14811)
- Add Isabell to team table
- reorder contact-us in leadership page
- Standardize "Contact us" on all departmental pages
- Convert all responsibilities to imperative mood verb phrase
- Untangle and deduplicate Engineering <> Product groups <> Product

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-11-21 13:55:46 -06:00
Luke Heath
d5885a4706
Update engineering handbook page (#15149)
Updating title to match the rest of the org.
2023-11-14 15:47:43 -06:00
Eric
ab71a272ae
Handbook: Add ritual for checking osquery Slack invitation link. (#15091)
Related issue: https://github.com/fleetdm/fleet/issues/15089

Changes:
- Added a new engineering ritual to check the Slack invitation linked to
from Fleet and the Fleet website. (Slack invitations expire after 400
people have accepted the invitation)
2023-11-10 13:27:51 -06:00
Luke Heath
91db043094
Use go variable to set version in workflows (#14890) 2023-11-03 09:42:27 -05:00
fredjohnsen
f5d5c91959
Fixed grammatical error (#14910)
...
2023-11-02 21:20:46 -05:00
Sampfluger88
0c30bc2b0b
Create customer-success.md (#14697)
...

---------

Co-authored-by: Zay Hanlon <114112018+zayhanlon@users.noreply.github.com>
Co-authored-by: Luke Heath <luke@fleetdm.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-11-02 11:06:30 -05:00
Luke Heath
59d002caae
Update freeze ritual and release readiness (#14868) 2023-11-01 15:25:02 -05:00
Noah Talerman
b72badccce
Update product DRIs and rituals (#14690)
- "Head of Product" => "Head of Product Design"
- #help-product => #help-product-design
- "Sprint kickoff review" is now one ritual that includes both MDM and
Endpoint ops teams
- "Pre-sprint prioritization" ritual is now one ritual that includes
both MDM and Endpoint ops teams
- Remove "Sprint release notes kickoff" ritual. Plan is to inform
#g-demand of new features asynchronously. Any discussion that needs to
happen live will happen at product office hours
- Remove "Report number of estimated stories (Endpoint ops))" and
"Report number of estimated stories (MDM)" rituals. One person (Head of
Product Design) is both reporting and tracking product KPIs
- Remove "Bug de-prioritization" ritual. Trying this instead: ~~CEO,~~
Head of Product Design, and Head of Product Development align on next
steps for which bugs to schedule into the next sprint and which can be
de-prioritized during the "Churned bug review" ritual. Less meetings.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-23 13:45:30 -05:00
Mike McNeil
bae8e9a600
Handbook: Clarify mdmctl (#14702) 2023-10-23 13:37:21 -05:00
Eric
4a6bf0d447
2023-10-24 Website: Update /try-fleet (#14638)
Closes: https://github.com/fleetdm/confidential/issues/4015

Changes:
- Changed the url for `/fleetctl-preview` to
`/try-fleet/fleetctl-preview`
- Updated the controller for the `/fleetctl-preview` page to redirect
non-logged-in users to `/try-fleet/login`
- Removed the route for `/try-fleet/sandbox-expired`, and added a
redirect going to `/try-fleet/fleetctl-preview`.
- Updated the controller for `/try-fleet/sandbox` to redirect the users
without a non-expired Sandbox instance to `/try-fleet/fleetctl-preview`.
- Updated `signup.js` to not provision Fleet sandbox instances for
users.
- Updated the `User` model to support a third `signupReason`: "Try
Fleet"
- Updated `/try-fleet/register` to submit "Try Fleet" as a
`signupReason` when users sign up.
- Renamed the files for the `/fleetctl-preview` page (`get-started` »
`fleetctl-preview`)
- Updated/removed Fleet Sandbox related handbook sections.
- Replaced the "Fleet vs Fleet Sandbox" section in the deploying
documentation with a note about `fleetctl preview`.
- Updated links to Fleet Sandbox in articles.

---------

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2023-10-20 13:59:18 -05:00
Lucas Manuel Rodriguez
99d131e96e
Fix not found link in the handbook (#14650)
...
2023-10-19 12:19:46 -05:00
Luke Heath
52f84d2233
Update engineering rituals (#14629)
...
2023-10-18 20:58:25 -05:00
Mike McNeil
8efac8b648
2023-10-17 Handbook: Product groups: Endpoint ops (#14589)
- Rename CX team => Endpoint ops
2023-10-18 15:56:53 -04:00
George Karr
c360d75c06
Add engineering specific Hiring process that was previously undocumented. (#14511) 2023-10-16 18:15:50 -05:00
George Karr
a8b790c617
2023-10-13 Add Certificate renewal steps to engineering handbook (#14501)
Adding the annual ritual to make sure our Cert is always valid for new
customers to generate Push certificates. ...

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-16 17:16:16 -05:00
Luke Heath
db93da95a8
Update sprint demos description (#14532)
I want to highlight: 

1. That we only demo features, improvements, and bug fixes. (not all
accomplishments might be unrelated to the release)

2. Specify that we want the content of the presentations to be
accessible to everyone and not too technical.

---------

Co-authored-by: George Karr <georgekarrv@users.noreply.github.com>
2023-10-14 16:57:43 -05:00
Luke Heath
eaa0fdda24
Update oncall engineer expectations (#14457)
.
2023-10-11 23:15:27 -05:00
Luke Heath
1511354766
Typo fix (#14421) 2023-10-10 13:47:37 -05:00
Sampfluger88
f108e997ba
Handbook: Engineering (update to new structure) (#14369)
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-10-09 21:42:45 -05:00
Isabell Reedy
1555d09f57
2023-10-05 Handbook: add process for inter-team assistance on bugs (#14235)
1. Process to formalize how we prioritize bugs across teams, recognize a
bug's origin, and indicate the team who is currently working on it.
2. Formalize that this coordination will happen at a joint sprint
kick-off review (there are currently separate sprint kick-off reviews
for each team).

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-10-07 10:18:00 -05:00
Luke Heath
cd34763c43
Fix broken link (#14332) 2023-10-05 14:59:49 -05:00
Martin Angers
a223cbc5c2
Update scaling-fleet.md (#14285)
Fix link to the list of tables referencing the hosts table (for manual
cleanup).
2023-10-04 22:35:18 -05:00
Luke Heath
1e1e28791f
Document milestone release ritual (#13932) 2023-09-25 14:35:36 -05:00
George Karr
0d95528378
Add policy for PRs to engineering handbook (#13898) 2023-09-13 10:26:49 -05:00
Luke Heath
4f82684198
Update oncall rotation documentation (#13888) 2023-09-12 14:18:01 -05:00
Luke Heath
d260817437
Update Eng Leadership (#13881) 2023-09-12 12:57:05 -05:00
Mike McNeil
b436fc71e2
2023-09-08: Handbook: Engineering: Bug states (#13818) 2023-09-12 10:20:38 -05:00
Luke Heath
8abc7f3a21
2023-09-07: Add freeze period exception to handbook (#13631)
.

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
Co-authored-by: Sampfluger88 <108141731+Sampfluger88@users.noreply.github.com>
2023-09-07 22:16:51 -05:00
Andrew Baker
fec1dcc662
2023-09-07: Handbook: Engineering dept: Sprint ceremonies (#13783)
Updating sprint demos verbiage in the handbook. This change reflects an
ongoing effort not to mention customer names so that we can share Sprint
Demos with the community..

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-09-07 21:42:16 -05:00
Mo Zhu
cb3b6729aa
typo for critical bug definition (#13522) 2023-08-25 17:43:16 -05:00
Luke Heath
fc944f6065
Add additional meetings to the engineering handbook (#13196)
. . .
2023-08-14 23:23:14 -05:00
Gabriel Hernandez
926bdd30af
doc updates for oncall and mdm migration light/dark logo feature (#12964)
quick doc change to oncall and product feature mdm migration light/dark
logos

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-08-03 10:38:41 +01:00
Eric
8fb22579ea
Reorganize Fleet documentation (#12871)
Closes: #12611

Changes:
- Added three new documentation sections `/docs/get-started/`,
`/docs/configuration` and `/docs/rest api/`
- Updated folder names: `/docs/Using-Fleet/` » `/docs/Using Fleet` and
`/docs/deploying` » `/docs/deploy/`
- Moved `/docs/using-fleet/process-events.md` to `/articles` and updated
the meta tags to change it into a guide.
- Added support for a new meta tag: `navSection`. This meta tag is used
to organize pages in the sidebar navigation on fleetdm.com/docs
- Moved `docs/using-fleet/application-security.md` and
`docs/using-fleet/security-audits.md` to the security handbook.
- Moved `docs/deploying/load-testing.md` and
`docs/deploying/debugging.md` to the engineering handbook.
- Moved the following files/folders:
- `docs/using-fleet/configuration-files/` »
`docs/configuration/configuration-files/`
- `docs/deploying/configuration.md` »
`docs/configuration/fleet-server-configuration.md`
    -  `docs/using-fleet/rest-api.md` » `docs/rest-api/rest-api.md`
- `docs/using-fleet/monitoring-fleet.md` » `docs/deploy/rest-api.md`
- Updated filenames:
- `docs/using-fleet/permissions.md` »
`docs/using-fleet/manage-access.md`
- `docs/using-fleet/adding-hosts.md` »
`docs/using-fleet/enroll-hosts.md`
    -  `docs/using-fleet/teams.md` » `docs/using-fleet/segment-hosts.md`
- `docs/using-fleet/fleet-ctl-agent-updates.md` »
`docs/using-fleet/update-agents.md`
- `docs/using-fleet/chromeos.md` »
`docs/using-fleet/enroll-chromebooks.md`
- Updated the generated markdown in `server/fleet/gen_activity_doc.go`
and `server/service/osquery_utils/gen_queries_doc.go`
- Updated the navigation sidebar and mobile dropdown links on docs pages
to group pages by their `navSection` meta tag.
- Updated fleetdm.com/docs not to show pages in the `docs/contributing/`
folder in the sidebar navigation
- Added redirects for docs pages that have moved.

.

---------

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-27 17:40:01 -05:00
Luke Heath
8fb694f20f
Add new timebox scrum item and related documentation (#12929)
There have been several tickets created for investigation or research
purposes like [this one ](https://github.com/fleetdm/fleet/issues/12904)
that we don't have a ticket type for within our current three types
(`story`, `~sub-task`, and `bug`). This results in the existing scrum
item types needing to be misused. I'm adding a fourth type called
`timebox` at Mike's request. I'm also including documentation on the
usage of this new type.

Lastly, I'm proposing we stop calling sub-tasks "unestimated sub-tasks"
in the GitHub template because it is confusing and inaccurate. Our
documentation states: "Sub-tasks are labeled as `~sub-task` and enable
us to break down complex tasks into more detailed and easier-to-estimate
work units.". In our estimation sessions, we put point estimates on
sub-tasks.

The spirit of this statement is that all sub-task points bubble up to
their parent story, and the parent story is what matters to the rest of
the business. That is clearly defined in our documentation and processes
and will not confuse our usage of stories.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-07-24 23:00:19 -05:00
Reed Haynes
a983631aaf
Update README.md community ticket timelines (#12826)
Update documentation on handling community bug reports. 

We will be notifying and then closing tickets at 2 and 4 week intervals
instead of the previous 3 and 6 week schedule.
2023-07-18 12:08:53 -05:00
Mo Zhu
c20fb1ec4b
Document that website team generates new schema (#12507)
Closes https://github.com/fleetdm/fleet/issues/12459
2023-07-13 14:56:16 -05:00
Luke Heath
361fcad29b
Adjust infra handbook (#12709) 2023-07-10 16:56:35 -07:00
Robert Fairburn
07f3faa18c
Initial infrastructure links and extra docs (#12661) 2023-07-10 14:00:39 -07:00
Mo Zhu
40fac12c51
Clarify check w/ EM and PM for user-impacting bug solutions (#12585) 2023-07-03 10:15:02 -07:00
Mo Zhu
a7def8bfa6
Revert to feature request (#12576) 2023-06-29 14:05:50 -07:00
Mo Zhu
47669377c5
Update engineering-initiated stories process (#12347) 2023-06-29 08:41:30 -07:00
Mo Zhu
642ad21087
Fix broken md link (#12524) 2023-06-28 08:26:15 -07:00
Luke Heath
5a177a2bb6
Add engineering accounts section to handbook (#12516) 2023-06-26 14:40:53 -06:00
Sharon Katz
73f0648c9b
schema (#12461) 2023-06-22 17:31:18 -04:00
Eric
0d94fece21
Website: Update route for article pages, update sub-page meta title in engineering handbook. (#12386)
Closes: https://github.com/fleetdm/fleet/issues/12385

Changes:
- Added a starting anchor to the regex route for Markdown article pages.
Currently, the regex route matches a sub-page in the engineering
handbook.
- Changed the `meta` title of the "Scaling Fleet" handbook page
2023-06-22 16:05:32 -05:00