Skip to content

Commit

Permalink
misc: Improve landing page handbook
Browse files Browse the repository at this point in the history
Found the list of links a bit plain, and not making clear what's actually
in the subsection. I think this is a better iteration for the handbook
landing page.
  • Loading branch information
ZJvandeWeg committed Jul 6, 2023
1 parent 00fb79f commit 2f7fcde
Showing 1 changed file with 34 additions and 29 deletions.
63 changes: 34 additions & 29 deletions src/handbook/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,39 +2,50 @@
navTitle: Handbook
---

## Introduction
# FlowForge Handbook

This handbook contains all the information about how FlowForge Inc. is run.

It's a living set of documents - they will evolve with time and expand as we learn
This handbook contains all the information about how FlowForge is run. It's a
living set of documents - they will evolve with time and expand as we learn
and discover new things.

The handbook is here for the whole company to help maintain. Pull-requests are welcome
and strongly encouraged.
Whilst instinctively we want to be open in all we do, there will inevitably by
content that is [not appropriate to make public][data-class]. That content is not
shared in this handbook.

[data-class]: /handbook/company/security/data-management/#data-classification

### Company
The handbook is here for the whole company to help maintain. Pull-requests are welcome and [strongly encouraged](#contributing).

- [Values](./company/values.md)
- [Vision](./company/vision.md)
- [Operations](./operations)
- [Product](./product)
## How FlowForge is run

### Development & Design Practices
| | |
|:----|:----|
| [Values](/handbook/company/values.md)<br /><p>The core principles guiding and driving the whole company</p>
| [Vision](/handbook/company/vision.md)<br /><p>Where we're going with FlowForge</p>|
| [Operations](/handbook/operations/)<br /><p>The day to day operations, tactical bizzops</p>
| [PeopleOps](/handbook/peopleops/)<br /><p>Humans aren't resources, so people ops</p> |
| [Communication](/handbook/company/communication.md)<br /><p>Increase signal, decrease noise.</p>
| <!-- placeholder for now --> |

- [Design](./design)
- [Development](./development)
- [Videos](./marketing/videos.md)
### How we build the product

### Sales and Marketing
| | |
|:----|:----|
| [Product](/handbook/product/)<br /><p>Planning, scheduling, and where the product will be a year from now</p>
| [Development](/handbook/development/)<br /><p>How features are delivered with velocity and quality</p>|
| [Design](/handbook/design/)<br /><p>How information is presented through UX/UI to users, prospects, and internally.</p>
| [Security](/handbook/company/security.md)<br /><p>Keeping what's private private, and what needs protecting protected.</p>|


- [Sales](./sales/)
- [Marketing & Communication](./marketing)
### Bringing the built product to market

### Internal Operations
| | |
|:----|:----|
| [Marketing](/handbook/marketing/)<br /><p>Keeping what's private private, and what needs protecting protected.</p>
| [Sales](/handbook/sales/)<br /><p>Meeting customer demand.</p>|
| [Customer Success](/handbook/operations/customer-success.md)<br /><p>Happy customers is what makes FlowForge a sustainable business.</p>
| |

- [Communication](./company/communication.md)
- [PeopleOps](./peopleops)
- [Security](./company/security.md)

### About the Handbook

Expand All @@ -46,20 +57,14 @@ also being written down for others to share. We could do that all on the interna
Google Drive, but by publishing in the handbook it allows for an open and honest
conversation about what we do.


#### Contributing

The handbook is maintained on [GitHub](https://github.com/flowforge/website/tree/main/src/handbook) and contributions can be made through pull-requests.

All changes merged to the `main` branch will be automatically deployed to the handbook on the
[FlowForge website](https://flowforge.com/handbook).

#### Private information

Whilst instinctively we want to be open in all we do, there will inevitably by content that is not appropriate
to make public. That content should be shared on the FlowForge Google Drive.

## Building the site locally
##### Building the site locally

To run the handbook locally, follow the instructions on the [website repository](https://github.com/flowforge/website).

Expand Down

0 comments on commit 2f7fcde

Please sign in to comment.