Commit Graph

102 Commits

Author SHA1 Message Date
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
Luke Heath
1b72e7d606
Update Eng Together meeting (#12397) 2023-06-22 11:26:57 -06:00
Roberto Dip
04db5f4049
update instructions to connect to dogfood db (#12408) 2023-06-22 10:07:00 -06:00
Luke Heath
f85decca2d
Add infrastructure section to engineering handbook (#12444) 2023-06-21 15:58:31 -06:00
Luke Heath
db2215e2e4
Update bug process in handbook (#12203) 2023-06-09 13:02:19 -05:00
Luke Heath
a46f926391
Engineering handbook fixes and merge freeze instructions (#12241) 2023-06-08 17:05:28 -05:00
Luke Heath
c36e3ec4b0
Update community PR process (#12228) 2023-06-08 12:03:19 -05:00
Eric
9ab1eed003
Update invalid osquery slack invitation link in markdown files (#12186)
Changes:
- Updated the old (now invalid) osquery slack invitation link to go to
fleetdm.com/slack (which redirects to a valid osquery slack invitation)
2023-06-07 17:29:57 -05:00
Luke Heath
6b80c97358
Move scaling Fleet section to its own handbook page (#12181) 2023-06-06 18:19:37 -05:00
Luke Heath
371b3e6888
Update engineering-initiated stories section (#12149) 2023-06-05 17:43:30 -05:00
Sharon Katz
e4717f2e89
Tidy up and bugs info (#12099) 2023-06-05 16:44:43 -05:00
Sharon Katz
6916bff516
Handbook changes (#12083)
Describing the fact that we forward Usage/Health metrics to DataDog
Describing our usage of Epics

---------

Co-authored-by: George Karr <georgekarrv@users.noreply.github.com>
Co-authored-by: Luke Heath <luke@fleetdm.com>
2023-06-05 12:30:42 -05:00
Luke Heath
179dc240ad
Add lukeheath to engineering handbook auto approvals (#12115)
I want to add myself to Engineering DRIs so I can iterate faster on the
engineering handbook.

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-06-02 17:43:35 -05:00