Codefol.io logo book

Your App Is Written From Your Point of View

May 9 2012

Programming is writing for a computer. But more importantly, it is writing for a human.

That function you just wrote tells a little story. It has a point of view.

Some functions are written to tell how a web request flows through them. They are clear, easy to read, and tend to do badly if something goes wrong. That’s not the story they are meant to tell.

The worst functions have no point of view. Perhaps they were written badly, or perhaps they were edited to death by a later programmer with a different point of view. But they are hard to follow because they change point of view.

Think about who you are writing for. Think about the story your function should tell.

Topics
Articles by Topic

a simple chalk face
About Me

RSS icon
RSS

Twitter logo in chalk
Twitter

Sign Up to Get Emailed Articles and Free Chapters.
* indicates required
If you sign up, I'll email you about software and how to improve at it. I promise to send you what I wish I had known.

Posts I Like

Where Do I Put My Code in Rails?
Why Do They Say Rails Doesn't Scale?
BigCo New Employee Training: Inside Voice
When Should You Not Use Heroku?
What's Deployment vs Provisioning vs Orchestration?
What is Rack? A Primer