3 ms·
This is a really interesting topic to me, because I've felt a pull toward things like this myself and seen it for decades. For example, the top of the README in
by sdegutis 8y ago
This is a really interesting topic to me, because I've felt a pull toward things like this myself and seen it for decades. For example, the top of the README in my Zephyros project[1] was very playfully done, and very well received too.
People are naturally more lighthearted and organic than the sterile software and documentation we tend to write, and we're more social too, wanting to connect with others even if it means through a simple in-joke or catch phrase.
[1] https://github.com/sdegutis/zephyros https://github.com/sdegutis/zephyros
- kashyapc 8y agoI am not saying to not be human and take all the zest out of the writing. FWIW, I suggest the book On Writing Well. William Zinsser has valuable advice on how we can still retain humanity in our writing without being dull and lackluster when dealing with dry and "sterile" topics like software.