Skip to content

All you need to know to work in and with SparkFabrik. Hopefully... :)

Notifications You must be signed in to change notification settings

noemi-mancini/company-playbook

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SparkFabrik dockerized Raneto-based playbook

This repository contains our company playbook (and possibly all the knowledge around our company-wide practices and policies), packed with a Raneto container to consult them.
Ideal destination for this stuff is on a domain like playbook.sparkfabrik.com. So far you can docker-compose up -d and visit http://playbook.sparkfabrik.loc to enjoy the result.

Contributions

So far the project is meant to be internal. All company members can download the project and provide merge-requests towards master branch.
The naming convention for the branches is:

  • section/section-slug-title for new sections (hardly they will be open by a company member, mostly it will be a matter of pre-made structure, but suggestions are welcome)
  • content/description-of-the-content for content contributions of various nature, like typo corrections, adding a new procedure or policy, etc
  • recipe/recipe-slug-title for new recipes

A broad list of still-to-be-stubbed contents can be found on this Trello board (restricted access to the management board, so far): https://trello.com/b/uJMBxjZZ/sparkfabrik-playbook-and-documentation.
A new board will likely be spawned to act as a "parking lot" for changes to this playbook and to track the contents proposals and issues.

Signaling issues or improvement

To keep things simple, we'll use gitlab issues to keep track of all improvements or ideas we'll have. If you notice something that can be made better and want to either signal it to the authors or work it out by yourself, please, open an issue on gitlab so that the commits can reference it.

What's inside

Basically this is the "SparkFabrik handbook". It is meant to be made public and contains all the information and recipes (hey) an employee has to know either before apply or during her everyday work.
You will get the major benefit if you are either:

  • A newcomer, recent hire or in you onboarding phase, to learn a lot of information on how we do what we do, how we communicate and which principles drive our decisions
  • A person in search for a procedure or information on how to perform a non-frequent task, such as manually lanching a build or reviewing an issue template
  • In search for the correct policy to communicate something to someone or to share something in the right place

What's NOT inside (and should never be)

SparkFabrik playbook is a public document. Since the recipes and articles show how we actually do things internally and provide transparent information to the world, the content should be triple-checked not to contain credentials, secrets, customer-related information (screenshots of real issues for example), etc.

It may surely contain links to internal resources as long as they are not publicly available.

Why

SparkFabrik grew a lot in its first year and it's now time to have a claer reference to either do stuff and take decisions.
This is a living document, not a carved-in-stone divine law. It will evolve as we evolve and try to represent our way of being.

Ownership

To date, the owner of this document is Paolo Pustorino ([email protected]) but any management representative or company shareholder with an active role in the company is entitled to manage the official version on his behalf.

About

All you need to know to work in and with SparkFabrik. Hopefully... :)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 78.6%
  • Dockerfile 15.6%
  • CSS 3.8%
  • Makefile 2.0%