- handbook
- Company
- Company
- Board & Investors
- Communications
- Decision making and project management
- Guides
- KPIs and OKRs
- principles
- Remote Work
- Security
- Asset Management Policy
- Business Continuity & Disaster Recovery Policy
- Information Security Roles and Responsibilities
- Operations Security Policy
- Risk Management Policy
- Third-Party Risk Management Policy
- Human Resources Security Policy
- Incident Response Plan
- Cryptography Policy
- Secure Development Policy
- Access Control Policy
- Information Security Policy and Acceptable Use Policy
- Data Management Policy
- Hardware Security Policy
- strategy
- values
- Operations
- Product
- Blueprints
- Feedback
- Glossary
- Market Segments
- Metrics
- Node-RED Dashboard
- Personas
- Pricing Principles
- Principles
- Product Growth
- Strategy
- Versioning
- Engineering & Design Practices
- Design
- Engineering
- Contributing
- Front End
- Packaging Guidelines
- Platform Ops
- Incident Response
- Observability
- FlowFuse Dedicated
- Staging Environment
- Production Environment
- Deployment
- Update Stacks on Production
- Project Management
- Releases
- Security Policy
- Support
- tools
- Website A/B Testing
- Internal Operations
- People Ops
- Coaching Plans
- Code of Conduct
- Compensation
- Expenses
- Hiring
- Holiday & Leave
- Job Descriptions
- CEO
- CTO
- Account Executive
- Product Marketer
- Chief of Staff
- Dashboard Engineer
- Product Manager
- Engineering Manager
- Solutions Engineer
- VP of Sales
- Developer Relations Advocate
- PeopleOps Policies
- Performance review
- Summit
- Marketing department
- Marketing
- blog
- Brand Voice
- Community
- Company Messaging
- Customer Stories
- Events
- FlowFuse for Education
- How we work
- Lead Activation
- Lead Generation
- Marketing - Website
- Marketing Programs
- Social Media
- Video
- Webinars
- Sales department
- Sales
FlowFuse Handbook
This handbook contains all the information about how FlowFuse is run. It's a living set of documents - collectively we'll iterate on it as we learn and discover new things.
About the Handbook
The FlowFuse handbook is inspired by the GitLab handbook. As an all-remote company, we share their rationale for having a handbook.
The aim is to avoid institutional knowledge building up inside our heads without also being written down for others to share. We could do that all on the internal Google Drive, but by publishing in the handbook it allows for an open and honest conversation about what we do.
Our handbook is more than just a collection of policies; it is the living embodiment of our core values. We believe that documenting our work and culture is essential to our success, and this handbook is how we put our values into practice every single day. It's how we ensure that information wants to be free, and that our collaborative community can thrive.
Why the Handbook Matters
It's All About Our Values.
- Results & Iterative Improvement: Our handbook is the ultimate tool for achieving results and making fast progress. When we write things down in the handbook first, we create a single, universally accessible source of truth for solutions and processes. This prevents the "torturous loop of interruptions, meetings, and suboptimal knowledge transfers" that happens when people have to constantly re-ask for information. By making the handbook a living document that is never finished, we embrace the idea that "everything is a draft" and can be improved with small, iterative steps.
- Collaborative Community: The handbook is the central hub for our community. We default to storing information in the handbook and on GitHub issues because information wants to be free. This asynchronous way of working ensures that discussions and decisions are not lost in private chats or forgotten after a meeting. This allows anyone to get the full context of a project and contribute, empowering our team members and fostering a shared sense of ownership.
- Constructive Candor & Customer Empathy: A public handbook is a powerful way to demonstrate constructive candor and customer empathy. By making our processes and culture transparent, we show our commitment to improving. A public handbook is open to suggestions from both our internal team and the wider community, allowing us to incorporate new perspectives and improve on our own ideas. This also helps us attract people who are already aligned with our values, as they can see our culture and mission firsthand.
Internal information
Whilst instinctively we want to be open in all we do, there will inevitably be content that is not appropriate to make public. That content is not shared in this handbook.
Contributing
The handbook is maintained on GitHub and contributions can be made through pull-requests. How to contribute is capture in a guide.
The handbook is here for the whole company to help maintain. Pull-requests are welcome and strongly encouraged.
To follow the latest changes in the Handbook, join the #gh-handbook channel on Slack.
Handbook-first
Being handbook-first means that our handbook is not a static document we update after a decision is made. It is the very place where our proposals and discussions happen. We believe that this approach is the most effective way to live our values and ensure that our communication is clear, efficient, and transparent.
Instead of starting a discussion on Slack or in a meeting, we start it in the handbook. Here’s how we do it:
- Start with a Proposal, not a Chat: When you have an idea for a new process, a change to an existing one, or a solution to a problem, you don't send a message on Slack. You create a proposal directly in the handbook. This proposal is a merge request that includes your suggested changes, allowing everyone to see and comment on the content directly. This ensures the full context of a discussion is preserved and universally accessible.
- Integrate Discussion and Documentation: The discussion about your proposal happens right there in the merge request. Team members can provide feedback, ask questions, and suggest edits. This allows us to disagree and commit in a transparent way. Once a consensus is reached or a decision is made, the final version is merged into the handbook, and the entire discussion trail is saved for future reference.
- Empower Everyone to Contribute: This system allows anyone at Flowfuse—from a new hire to a senior leader—to contribute directly to our company's culture and processes. It generates a shared responsibility to maintain the pace of documentation through a pay-it-forward mentality. The history of every change is visible, showing how learning happens and how iteration shapes proposals.
- Eliminate Wasted Effort: By making the handbook the hub of our collaborative work, we ensure that the information we need is always where it should be. This prevents us from having to document something after the fact—a step that is often skipped—and avoids the "torturous pattern of people pinging people for updates". This is how we prioritize results and stay focused on what matters.
How FlowFuse is run
To run our company we provide a comprehensive guide outlining policies, procedures, and expectations, fostering consistency, clarity, and effective communication within the organization.
| Values The core principles guiding and driving the whole company |
|
| Strategy The high level plan for our objectives at FlowFuse |
|
| Operations The day to day operations, tactical bizzops |
|
| PeopleOps Humans aren't resources, so people ops |
|
| Communication Increase signal, decrease noise. |
|
How we build the product
| Product Planning, scheduling, and where the product will be a year from now |
|
| Development How features are delivered with velocity and quality |
|
| Design How information is presented through UX/UI to users, prospects, and internally. |
|
| Security Keeping what's private private, and what needs protecting protected. |
Bringing the built product to market
| Marketing How we reach companies that can benefit from FlowFuse. |
|
| Customer Success Happy customers is what makes FlowFuse a sustainable business. |
|