Write better Protips
Dear fellow writers,
You are publishing really good pro tips, really.
Yet, please let me give you some tips about writing interesting and useful tips for your readers and your future self.
- Write a short introduction : even a line is enough to explain classic use case of the tip, where it's coming from
- Explain the tip : do not simply copy and paste a line of code or some super crazy shell fu : explain it. In my point of view it's always good to explain a little what's going on there.
- Cite your sources : you are not covering some high risk topic, technical sources are a way for readers to check a bit more about the tip and what you are describing (or using)
There is mainly three reasons to add such things :
- It forces you to read the tip again and think about it, you'll avoid some errors
- It will be easier for readers, not coming from the same background and mind state as you do to understand it
- It will help your future self, facing a similar problem, to remember how that tip's content came to be
That said : thank you for all your pro tips, several of them already made my life easier : please keep writing !
Written by Thomas Riboulet
Related protips
8 Responses
(somehow) related : http://stylemanual.org
over 1 year ago
·
Great
over 1 year ago
·
Never saw in that way. Good tips, thanks. It will also works for me when writing other publications.
over 1 year ago
·
@summic , @andresroberto10 , @sasasoftware : you're welcome, thanks !
over 1 year ago
·
Example would be nice ^_^
over 1 year ago
·
Simple but essential. :)
over 1 year ago
·
Nice, tips
over 1 year ago
·
graet
over 1 year ago
·
Have a fresh tip? Share with Coderwall community!
Post
Post a tip
Best
#Coderwall
Authors
Sponsored by #native_company# — Learn More
#native_title#
#native_desc#