CategoryUncategorized

All Marketers Tell Stories

All Marketers Tell Stories by Seth Godin helped me understand why I feel that marketing is a dirty job. It says, that the marketing process is about making someone feel a certain way, rather than them feeling it on their own. On one hand, this seems like psychological trickery, on the other, it seems obvious that even our day-to-day lives are about making people feel things.

The broad concept of the book is simple, we understand the world through stories, and that feelings matter more than fact.

Stories make it easier to understand the world. Stories are the only way we know to spread an idea.

The facts are irrelevant. In the short run, it doesn’t matter one bit whether something is actually better or faster or more efficient. What matters is what the consumer believes.

We’d like to believe that people are rational and informed. They are neither.

But what does the consumer believe in, and how do we use that to tell our story?

Continue reading “All Marketers Tell Stories”

The Prince

The Prince by Niccolò Machiavelli (Wikisource) is part of a series of books that I need to read before I can read Collective Choice and Social Welfare. The book started with a promising letter that made me think that the rest is going to be about good governance from a common person’s perspective.

Just as artists who draw landscapes get down in the valley to study the mountains and go up to the mountains to look down on the valley, so one has to be a prince to get to know the character of a people and a man of the people to know the character of a prince.

Reading on, I was a bit disappointed when the author decided to not consider republics. I would have recovered from the disappointment, if things hadn’t taken such a violent turn:

…especially if its people are not used to the freedom of self-government. In that case all you have to do is eliminate the family of the previous ruler and your hold on power is guaranteed.

…in general you must either pamper people or destroy them; harm them just a little and they’ll hit back; harm them seriously and they won’t be able to.

Now I was confused, I had completely misunderstood the motivation of the author. So, I looked up Wikipedia, and for the first time learnt the meaning of Machiavellianism (I remember having ignored this word several times while reading other books and blog posts).

I did not know how to make notes from a book written by someone with such cynical disregard for morality. So, after some thought, I decided to take notes as the prince himself, notes for a violent king.

Continue reading “The Prince”

Bird by Bird

Reading Bird by Bird is like having a friend console me about my fears and pains of writing. By showing us the very real and messy process of writing, Ann Lamott tells us that writing is never a linear journey from inspiration to finished work. She talks about all the potholes, detours and breakdowns on the way.

A quick disclaimer, the way I am about to write about this book is like describing a sunset as – ball of fire hidden from view due to a rock’s rotation. Please don’t read this summary, go read the book instead.

Lamott tells us that we don’t know what we’re going to write till we start writing, so the only way to start is by putting something down on paper. Things will emerge as we start writing. It’s ok for the first draft to be a mess, it is supposed to be. Perfectionism only blocks playfulness.

As we make writing a habit, putting in the hard work of working on our drafts, we slowly start fixing, checking, and polishing our work. Small amounts of work done regularly creates the larger work, we just have to take it bird by bird.

Stories too aren’t pre-determined, and come out of the writing process, Lamott says. She asks us to focus on our characters and environments; really understand who and what they are. What the characters do should drive the story, the story should never force them to do something just to move the plot. The environments and places should tell us the characters values, personality and history in ways that the characters themselves can’t. Genuine stories are built by characters and environments, never the other way around.

In the beginning we’ll have to borrow others’ voices to tell our stories. The stories might not be our own either. Lamott says that’s alright. As long as we persevere and practice, we’ll get better at understanding ourselves, understanding what we really want to say, and how we want to say it. Writing is about telling our truth, and our truth can only come out in our own voice.

The Pocket Emma Goldman

The Pocket Emma Goldman is a collection of Goldman’s writing taken from the Anarchist Library. You can read it in full — online for free — and I’d highly recommend it. Each sentence in this book is full of truth and power.

Goldman sees the world with utter clarity. When I am thinking about the world I stop myself when I see a structural barrier, thinking that it can’t be overcome. Goldman examines every barrier and sees it for what it really is, an artificially created human structure that can and should be taken down:

When, in the course of human development, existing institutions prove inadequate to the needs of man, when they serve merely to enslave, rob, and oppress mankind, the people have the eternal right to rebel against, and overthrow, these institutions.

The mere fact that these forces — inimical to life, liberty, and the pursuit of happiness — are legalized by statute laws, sanctified by divine rights, and enforced by political power, in no way justifies their continued existence.

Page 35
Continue reading “The Pocket Emma Goldman”

Scalable and Modular Architecture for CSS

Cover of the book Scalable and Modular Architecture for CSS (SMACSS) by Jonathan Snook

SMACSS by Jonathan Snook is referenced in numerous articles about on CSS and so I finally decided to read it. I can see now how the ideas in this book would have served as a seed for conventions like ITCSS and BEM.

Structured and organized CSS is easier to build on and maintain. Naming conventions improve clarity. Independence from HTML structure means that components can be moved around freely. A balance between class name only selectors, and nested selectors is key for maintainable CSS. Overall our goal should be to increase semantics and decrease reliance on specific HTML structure.

SMACSS attempts to achieve this by creating categories of elements and by creating some conventions on how to split and write your CSS. The author makes it clear that these are just guidelines and need to change as per the project and its realities.

Continue reading “Scalable and Modular Architecture for CSS”

I haven’t been able to spend a lot of volunteer time on Wikisource this year. So, instead of transcribing the 333 pages of History of India Vol II, I started validating Tagore’s work Nationalism. It’s a relatively small work, and Balajijagadesh and others had already done a great job transcribing and proof-reading it. The work is now fully done, ready to be downloaded and read. I even nominated it to be the featured text! This is my first time doing it, let’s see how it goes! 🤞🏾

The Coldest City

Cover of the book The Coldest City

After reading Logicomix on the Kindle app, I decided to try one more from my wishlist. The Coldest City was more fun to read because it was formatted specifically for the the app. Each “page turn” would pan between frames and then show the entire page before moving to the next one.

Actually, no! It wasn’t formatted like that. I just checked; it was static pages. I read it almost two years ago and this how my brain decided to remember it because of the art. The understated black and white style really drew me in. Most of the book doesn’t have much action, but drawing and layouts added so much action even in the static frames. See for yourself:

Panels from the book The Coldest City

I am looking forward to reading more work by Antony Johnston and Sam Hart, and will start with the free version of Fuse #1 (sorry for the Amazon link 😞). Hoping to get some printed versions soon.

Design Systems Handbook

Cover of the book Design Systems Handbook

I’ve been involved in the process of instating a design system twice. First, with the short-lived attempt to move the MediaWiki platform to mediawiki.ui. And second, replacing mediawiki.ui and whatever else MediaWiki was using to OOUI.

While the first attempt was limited to a small CSS file and KSS generated documentation, the second one came with a full-fledged demos page and a styleguide to go with it. MediaWiki is in the process of transitioning once again, now to Vue.js. This time though, things are different, the style guide remains in place, it is only the implementation of the components that’ll change.

So when I first heard about the Design Systems Handbook on the Design Better podcast I was immediately interested. Large legacy products like MediaWiki have long suffered from bespoke designs for every corner. Design systems that can scale-up help build products faster.

Continue reading “Design Systems Handbook”

🔖 Design systems (archive)

Design systems aren’t just the what of patterns and components, but also the how of putting these elements togethers. Along with patterns, the design systems should also explain:

  • the problem being solved
  • when the pattern should be used
  • when the pattern should not be used

How to Take Smart Notes

I’ve always found writing to be an impossibly hard thing to do. So, for the last few years I’ve been trying to learn and practice it more often.

Cover of the book 'How to Take Smart Notes'

I’ve also always felt like I have thoughts that I never really know how to express. I’m amazed when other people are able to say the things that I am thinking more clearly than the way I’ve been thinking them. I see that people who’ve studied at good universities, or are generally smarter than me are just able to do this. When I discovered this book — How to take Smart Notes by Sönke Ahrens — I didn’t expect it would have anything to do with this, but it ended up giving me an insight into the learning and writing process of academics.

The book describes an external system for reading, thinking, and writing. It argues that moving things into an external system enables learning and frees up our brains. By putting things in an external system, we give our brains permission to forget and focus instead on thinking.

The gist of the system is:

  1. While reading, make notes using your own words. Only when we’ve actually understood the material can we express it in our own words
  2. Link these notes with other notes that could be related — this helps uncover patterns. Forming these connections also helps our memory, and recall becomes easier in the correct context
Continue reading “How to Take Smart Notes”

Gutenberg editor color palettes for WordPress themes

One of my favorite features of the Gutenberg block editor is the editor color palette. It allows themes to register a color palette that is shown in the block editor whenever a block needs to choose a color.

Allowing the theme to have a say in the styling of the content of the post is a powerful idea. It helps guide the user’s design choices while still allowing them freedom to make changes. When working on Zuari, it was important for me to get this right since the theme is otherwise just black and gray. 

Editor colors from Zuari
Since I am not very good at colors, I collected over a hundred references on Pinterest to pick and tweak from.

Once we have the colors picked and named (This can be tricky. What is ecru?) we need to let WordPress know that our theme would like to register a palette, and add our colors to it:

add_theme_support( 'editor-color-palette', array(
            array(
                'name' => __('Brick', 'zuari'),
                'slug' => 'brick',
                'color' => '#825A58'
            ),
            array(
                'name' => __('Baby Pink', 'zuari'),
                'slug' => 'baby-pink',
                'color' => '#E0BAC0'
            ),
            array(
                'name' => __('Ecru', 'zuari'),
                'slug' => 'ecru',
                'color' => '#E1D9D3'
            )
) );

Next, we’ll need to add two CSS classes for each of these colors so that they can be used on the different blocks as background and foreground colors. The naming convention for these classes is has-{slug}-color and has-{slug}-background-color:

.has-brick-color { color: #825a58; }
.has-baby-pink-color { color: #e0bac0; }
.has-ecru-color { color: #e1d9d3; }

.has-brick-background-color { background-color: #825a58; }
.has-baby-pink-background-color { background-color: #e0bac0; }
.has-ecru-background-color { background-color: #e1d9d3; }
Screenshot of Color settings in Gutenberg

That’s it! This will add the color palette to the block inspector for any blocks that need color, and show the right colors in the website once they’re selected.

I hope that WordPress adds these colors as options in the Customizer panels as well, allowing for more design guidance coming from the theme. I’ve been thinking about WordPress themes as design patterns and guidelines rather than skeletons for a website. I’ll be writing about this soon.

🔖 How the Blog Broke the Web (archive)

Web homepages used to be weird hand-made things until blogging and content-management systems like Movable Type came into the picture in 2001. People switched to these systems because they were easier to use, but it meant that everyone got reverse-chronological diaries whether they liked it or not. This trend has continued with Twitter, Instagram, Facebook etc.

A reverse chronological feed is not the only way that hypertext can be molded, but the early systems have put the web on this trajectory. Other shapes of hypertext like wikis or forums have not remained as popular and don’t have many tools around them either. Even newer shapes of hypertext could still be discovered.

The Backlog

All of us have a bunch of different backlogs — emails, todo tasks, articles to read. New backlogs get added all the time too — recipes to make, podcasts to listen to, places to see. While we keep working on our backlogs, the problem is, that we add to them faster than we subtract.

The book you just finished reading references others that are now on your reading list. After releasing your new project you already have a list of things that you need to fix in it. As you constantly move closer to death – the time you have is decreasing, but, your backlog is increasing, often exponentially. This is not sustainable!

the backlog graph
I wish I had better memory of this day

So what are we supposed to do? Prune? Prioritize? Panic? I’ve been practicing an unhealthy balance of these three for a while and am increasingly getting comfortable with its constant hum bothering me. As long as I keep making new spreadsheets and projects on Todoist, I’ll be just fine 😅