Are you looking for the playbook? Read and search it at playbook.dxw.com
It's dxw's playbook. It explains how we get things done.
The playbook documents how the playbook gets changed. See the changes to this document section for more information.
dxw's playbook is released under a Creative Commons Attribution-NonCommercial licence. You are free to reuse and adapt this content with credit, for non-commercial purposes.
This is the main playbook. Unless there's a good reason, we should record all process and policy here.
This section contains more detailed documentation on how to do things. It's mostly aimed at developers, but can contain any detailed documentation on a specific task or subject. Like research activities, this is quite detailed and isn't of general interest, so it gets its own section.
There is a guide to editing the playbook, and creating new content, in contributing. This is also available on the published playbook.
These documents are maintained by everyone at dxw, and it's important that their quality and tone is consistent.
The document primarily talks about what "we" do. If you can phrase what you're saying in these terms, do. If it sounds weird, or you're actually talking about what an individual needs to do in a given circumstance, use "you".
Link liberally, both within the document and to useful things on the web. Don't reinvent the wheel! If someone else has already written up a great explanation of something that we agree with, just link to it.
This is a long document. Try to avoid making it too much longer. Keep things simple. Don't use flowery language or unnecessary words.
This document is for everyone. If you find yourself talking about something specialised or technical, you're probably in the wrong place. Should you be writing a guide?
This is a public document, because it's good to be open. But some things are private. You can put them in the private playbook, when we have one!
Use second level headings for main sections, third for subsections and fourth level ones if you need to. Don't use fifth or first level headings. The table of contents in the HTML version is automatically generated, and it assumes this structure.
To make changes to the playbook theme, you will need to install the dependencies:
npm install
go get github.com/errata-ai/vale
Then to start a local development server run:
npm start
You can now visit localhost:3000 to see your local
playbook. Theme files live in the /build directory
Check your changes for markdown errors:
npm run lint
To run the prose linter:
npm run vale
This will only show errors and warnings by default. If you want extra suggestions for better writing, run:
npm run vale-suggestions