I’m currently fascinated with Gitlab’s handbooks. I heard of companies trying to be more open to the public, but the extent that Gitlab is doing is unprecedented. They are documenting everything publicly. Most, if not all, internal processes are getting written for everyone to see.
- How admissions are done? It’s there.
- How and when employees are bonuses? It’s there too.
- What is the ERP used? It’s there.
- In fact, what is the whole list of external software and service used? It’s there too.
- The scripts used to manage it’s own site? It’s there too.
- Personal information, like employees actual salaries? Of course, are not there.
Too much information? Maybe. But it’s definitively inspiring.
Another source of personal inspiration comes from a guy on Twitter: Keijiro Takahashi. This japanese programmer does several mini-tools for himself but publishes everything on Github with minimalist’s licenses like MIT.
In contrast, I was checking my LinkedIn the other day then I decided to share my Gitlab and Github accounts. There are so many projects over there. #ButNot. Most, almost all, were private! Many game prototypes, small side projects. All locked. Some are basically live backups, since are not updated for ages. So I decided to do two things:
- Open some of the closed projects
- Git-fy some of my personal and professional projects
- Documentation as code for my new company
The first is pretty straight. Mostly checking a box. Sometimes adding a small README or LICENSE files. Few times making real changes.
The second is a new mindset: I have dozens of small projects, from games to personal scripts, that I’ve never used git to track changes. But not only I could get better control of it, but also I could share with the world. You will see more and more projects popping up in my Gitlab account page.
The third, follow partially Gitlab’s way. I’m considering in documenting most of the processes in git-like wikis. It will not only good sharing the knowledge with other employees and partners. It’s also good for tracking the business decisions that changed these processes. A rather clever approach.