This repo has been moved to https://github.com/countable-web/ops-manual. We are keeping this old version to preserve links, but you should use the new one.

TODO: port this to use a documentation generator, like https://readthedocs.org/dashboard/

This is the Countable Web Productions Inc. operations manual. It's a living record of how our company works, and is constantly evolving as we learn. Our whole team proposes amendments in order to constantly improve the material here.

Like for an open source software project, our processes and other information assets are publicly available for anyone to use under the MIT license. However, just as an open source software project does not disclose its database contents, this repository does not include any of our clients' and employees' private data.

First, why does this repository exist? The purpose of this repository is to document Countable's operations for convenient reference, discussion and amendment.

Whenever you find yourself saying something for a second time (to a second audience, or in a second situation), it is highly likely that you will end up saying it again and again in the future. To vastly improve the quality of the communication, and reduce the amount of time that you spend communicating it … write it down.
Then, the next time you need to communicate that message, you can simply share it in written form. If it is something that all members of the team should know and remember, put it in a company-wide Wiki. If it is truly seminal to the organization, post it on a wall for all to see.

-- "The Great CEO Within", By Matt Mochary

Second, why is it open source? To promote transparency.

This repo will contain:

• Business processes and knowledge base.
• The Articles of Incorporation and other general corporate documents. Countable is a CCPC, but it's possible some of these documents may be useful for other organization structures.
• Document templates used by the company for accounting and legal.
• We will not publish information here that would compromise the privacy or property of our employees, clients or customers. For example, filled timesheets, invoices and other documents with monetary specifics of other parties will not be filed here. For these, only empty templates will be provided.

Countable is a Web Technology Solutions Development Firm. We build things with web technology. There are tens of thousands of companies that do this. What makes us different?

• We are obsessed with feedback. A remote team, feedback loops are harder to establish and even more critical to our ability to deliver great work. At Countable, feedback is sacred, and everyone is encouraged to maximize thoughtful feedback to one another as much as possible. We want our clients to see our work as we're doing it and be as visible as possible.
• We're built to address the 3 main failure modes of software projects (over budget, overdue, and incorrect requirements). We do this by prototying, the art of simulating an experience with the minimum effort.
• We work hard to be transparent, interactive, and have fun.

Read about the purpose of Countable.

We are selective in order to embody our values. This starts with hiring, all the way to the kinds of partners we seek out. In the end, we want to bring together people to have a big impact by improving all the industries we engage with, through better technology designed by the end users themselves. Those users are the ones who understand their problems and need to given a voice to control the technology they depend on. Now that's a feedback loop!

Finding the right people is one of our biggest challenges, so we need every advantage we can find in this way.

• General Posting
• Are You A Good Fit For Countable?

Helps us find the best partners and team members who share our passion.

• Value Proposition
• Creative Brief
• Design Asset Storage
• Social Media Posting Policy
• 2018 Search Engine Optimization (SEO) Checklist
• Usability

If you're a new Countable team member, start here!

• Onboarding
• Your Contract
• Diversity and Inclusion
• Physical Setup
• Project Management
• Evaluation
• Compensation
• Recommended Reading
• Scrum
• Trello
• Client Data Protection

If you're a new client, start here!

• Scrum
• Trello

The purpose of this section is to standardize key (not all) product/engineering processes in order to improve the team's performance, and take advantage of an experience curve by eliminating arbitrary process differences.

• Code Project Standards
• Coding Standards
• Operations
• Prototyping
• Testing
• Training
• Architechture
• Dependencies
• Django
• Docker
• Git
• Jenkins
• Stack Choices

How to provide the best results for clients.

• Priorities
• Methodology
• Communicating with clients

• Meetings
• Processes
• Storage
• Gathering Team Feedback

If you want to suggest a change to Countable Web Productions, make a pull request. The rules:

• Important: Never commit private data or protected intellectual property. Nothing specific to our employees, clients, or finances should go in here.
• The easiest place to contribute an idea is by joining our company's board of advisors on reddit.
• Organize by "context". The documents in here are intended to be actionable. So, for any document, place it with a name and folder structure that matches what someone is doing when they need this information. For example, a timesheet template should go in the GETTING_STARTED folder, since it will be used by new employees.
• Link prolifically. Wherever you can, link words of your pages to other pages or other websites.
• Keep it concise, to-the-point, actionable. If you do use an abstraction, provide a corresponding example.
• Each page should state it's purpose for existing, as related to the company's mission. Clarity and utility over completeness. Try to maximize "usefulness density", or the total benefit (ie, in saved time, dollars) of the content divided by its length (in characters).
• This repository is intended for a specific company (Countable Web Productions Inc.), if you want to use it for another company, please fork it.

• Some companies open source aspects such as coding standards, ie Caktus
• GitLab handbook
• Remote Only Manifesto
• The Great CEO Within - Matt Mochary writing a book for his network of startups to succeed.
• Buffer Is a radically transparent company that publishes internals too! We love and admire them for it :)
• X-team has been proactive in publishing their processes online in some detail on their website.
• netlify culture handbook