Skip to main content

Software Development Lessons (learned the hard way)


These are the exhaustive list of lessons Julia Biason learnt in 30 years working with software development.

 Folks who have spent some time in software development can easily connect with them. 

 Programming

  • Before you start writing code...
    • Spec First, Then Code
    • Write Steps as Comments
    • Gherkin Is Your Friend to Understand Expectations
    • Design Patters Are Used to Name Solution, Not Find Them
    • Thinking Data Flow Beats Patterns
    • The Magic Number Seven, Plus Or Minus Two
    • Cognitive Cost Is The Readability Killer
    • Learn The Basics of Functional Programming
    • Shortcuts Are Nice, But Only In The Short Run
    • Debuggers Are Overrated
    • Think About The Users
  • Testing Software
    • Unit Tests Are Good, Integration Tests Are Gooder
    • Testing Every Function Creates Dead Code
    • Tests Make Better APIs
    • Make Tests That You Know How To Run On The Command Line
    • Good Languages Come With Tests
  • Documenting your code
    • Documentation Is A Love Letter To Your Future Self
    • The Function Documentation Is Its Contract
    • If A Function Description Includes An "And", It's Wrong
    • Good Languages Come With Integrated Documentation
  • Source Control
    • Always Use A Version Control System
    • One Commit Per Change
  • Project Organization
    • Organize Your Code by Data/Type, Not Functionality
    • Create Libraries
  • Writing code
    • Be Ready To Throw Your Code Away
    • Future Thinking Is Future Trashing
    • Don't Use Booleans As Parameters
    • Beware of Interface Changes
    • It's Better To Let The Application Crash Than Do Nothing
    • If You Know How To Handle It, Handle It
    • Types Say What Your Data Is
    • If Your Data Has a Schema, Use a Structure
    • Don't Mess With Things Outside Your Project
    • Resist The Temptation Of Easy
    • Start Stupid
    • Always Use Timezones With Your Dates
    • Always Use UTF-8 For Your Strings
    • Optimization Is For Compilers
    • Units Makes Things Clear
    • If It Doesn't Run On Your Computer, You Have A Problem
  • Making Things Go
    • The Config File Is Friend
    • Command Line Options Are Weird, But Helpful
    • Not Just Function Composition, But Application Composition
    • Even for Application Composition, Start Stupid
    • Logs Are For Events, Not User Interface
    • Learn To Monitor

Community/Teams
  • A Language Is Much More Than A Language
  • Understand And Stay Away From Cargo Cult
  • "Right Tool For The Job" Is Just To Push An Agenda
  • The Right Tool Is More Obvious Than You Think
  • Code Reviews Are Not For Style
  • Code Formatting Tools Are Ok, But No Silver Bullet
  • Code Style: Follow It
Personal
  • Companies Look For Specialists But Keep Generalists Longer
  • Keep A List of Stupid Bugs That Took More Than 1 Hour To Solve
  • When It's Time to Stop, It's Time To Stop
  • Code of Conduct Protect YOU, Not THEM
  • Learn To Say No
  • Take Responsibility For The Use Of Your Code
  • Don't Tell It's Done When It's Not

Source: https://blog.juliobiason.net/books/things-i-learnt (Author has written elaborate explanation on each of the mentioned lessons)

An interesting discussion on the above subject can be found at Hacker News

Whats your take on Software Development? Feel free to share your thoughts in comments below.
Labels:

Comments

Post a Comment

Popular posts from this blog

Team Work

5 comments
Read more

Ramo Vigrahavan Dharmah

A great verse from Ramayana: आहार निद्रा भय मैथुनं च  सामान्यमेतत् पशुभिर्नराणाम् । धर्मो हि तेषामधिको विशेष:  धर्मेण हीनाः पशुभिः समानाः ॥ AhAra-nidrA-bhaya-maithunam cha samAnam_etat_pashubhir_narANAm | dharmo hi teShAm adhiko visheSho dharmeNa hInAH pashubhiH samAnAH|| Eating, Sleep, Fear and Sex ; these habits are common between human beings and animals. It is the Dharma which is the special quality of the human beings. Without the Dharma, they are similar to the animals.  Rama is The Embodiment Of Dharma.  Maaricha, while speaking to Ravana- (Aranya Kandam 37-13): रामो विग्रहवान् धर्मः साधुः सत्य पराक्रमः | राजा सर्वस्य लोकस्य देवानाम् इव वासवः || ३-३७-१३|| raamo vigrahavaan dharmaH saadhuH satya paraakramaH | raajaa sarvasya lokasya devaanaam iva vaasavaH || 3-37-13 "Rama is the embodiment of righteousness, he is an equable person with truthfulness as his valour, and as with Indra to all gods he is the king of entire world. [3-37-13] Another great phra
Post a Comment
Read more

Procrastination to Motivation (Regulate your emotions)

You Procrastinate Because Of Emotions, Not Laziness. Regulate Them To Stop Procrastinating! There are two trains of thought – One leads to procrastination and one leads to motivation. And somewhere in between, there is a junction called anxiety. Procrastination train of thought: People procrastinate or avoid aversive tasks to improve their short-term mood at the cost of long-term goals. Procrastination is not a time management problem. It is an emotion regulation problem - we delay activities which might make us feel not-so-good. Procrastination is not laziness. Humans procrastinate because of poor emotional regulation about the outcome of tasks. In short, we often procrastinate because of perceived anxiety, stress, and poor emotional regulation about the completion of a task. Perceived anxieties make us feel ‘not so good.’ The aversion activity is a mechanism to avoid or delay the anxiety and repair the short-term negative mood. Habits like procrastination are a reaction
Post a Comment
Read more