search

axelerant / engg-handbook

Axelerant Engineering Handbook
https://engg-handbook.axelerant.com/
2 stars 9 forks source link

There are a lot of principles #6

Closed hussainweb closed 1 year ago

hussainweb commented 1 year ago

The risk with a lot of principles is that it becomes useless. It gets difficult to read, let alone remember a dozen principles and they stop being effective. We need to creatively combine them in single headings yet keep the message.

Since we are at the writing stage right now, we should only focus on adding new content. We should consolidate this once we are happy with the coverage of the content.

subhojit-axl commented 1 year ago

I think only the fundamentals fall under the principle. Rest, can be moved to a new section called culture. What do you think?

hussainweb commented 1 year ago

Thanks, @subhojit-axl. I don't see what we could talk about "Culture" here as it means many things. For one thing, a lot of it is covered in the Axelerant handbook itself. From an engineering perspective, everything we talk about falls under behaviors (a lot of these principles are also very close to behaviors). What else could we write there?

subhojit-axl commented 1 year ago

Editing my last comment:

Principles:

Engineering Focus Build for people Fundamentals No reinvent wheel Tradeoffs Automation Tests OSS

Behavior:

Ask for help Bold and experiment Curious Perfectionist Bus factor

hussainweb commented 1 year ago

It's a great start. I had a few things in mind along these lines. Let me cross-check.

subhojit-axl commented 1 year ago

btw I got the idea from here https://abseil.io/resources/swe-book/html/toc.html

subhojit-axl commented 1 year ago

This will be fixed in #9