389 private links
These tips are related to academic papers, but it can be applied to every writings that should have an effective communication.
Some that can affect me:
- avoid passive tense
- use strong vers instead of lots of nouns: "make assumption" → assume, "had difference" → differed, "is an illustration" → illustrates
- if you find yourself saying "In other words," it means you didn't say it clearly enough the first time. Rewrite it.
- Avoid filler words, e.g., by converting sentences into simple actor-action-object phrasing.
- Each sentence in a paragraph must have some logical connection to the previous one. A new thought should get its own paragraph, but still clearly needs some logical connection to the paragraphs that preceded it.
- avoid scare quotes
- Numbers ten or less are spelled out: "It consists of three fields", not "3 fields".
- avoid in-line enumeration
- avoid itemization (bullets) as it takes extra space. Bullets can be used to emphasize key points
- name the author with its reference [1] instead of "[1] shows" only. Add "et al." if more authors exist. Cite in depth the section for example to accord the verb.
- more than two footnotes per page or a handful per paper is a bad sign.
- A part before a colon (":") must be a complete sentence.
- Avoid slash constructs: time/money, expand them such as "time and money".
- Avoid cliches like "recent advances in ..."
- Avoid symbols as they are only acceptable on slides.
- Uses uppercased words for acronyms only. Avoid it for technical terms.
- Expand all acronyms on first use, except acronyms that every reader is expected to know. For example, TCP in a research paper is not needed, but Yet Another Compiler Compiler (YACC) is.
- Divide powers of a 1 000 for readability. It can be adjusted by the locale used.
- Use "kb/s" or "Mb/s," not "kbps" or "Mbps" - the latter are not scientific units. Distinguish MB and Mb too.
- It is always kHz.
- It's Wi-Fi, not WiFi or wifi that are trademarks.
- Avoid "etc.", prefers "for example", "such as", "among others" or provide a complete list.
- "for example" or "like" and "etc." are in different phrases. It already indicate that there are more such items.
- Remember that "i.e." and "e.g." are always followed by a comma.
- Do not use ampersands (&) or slash-abbreviations (such as s/w or h/w) in formal writing; they are acceptable for slides.
- "Respectively" is preceded by a comma, as in "The light bulbs lasted 10 and 100 days, respectively."
- Therefore, however, hence and thus are usually followed by a comma, as in "Therefore, our idea should not be implemented."
- Use "in Figure 1" instead of "following figure" since figures may get moved during the publication or typesetting process.
- Figures show, depict, indicate, illustrate. Avoid "(refer to Fig. 17)".
- Often, it is enough to simply put the figure reference in parenthesis "Packetg droppers (Fig. 17) have a pipe to the bit bucket, ..."
- If you quote something literally, enclose it in quotation marks or show it indented and in smaller type ("block quote"). A mere citation is not sufficient as it does not tell the reader whether you simply derived your material from the cited source or copied it verbatim.
- Acknowledge your funding support.
- Integrate PostScript instead of GIF for images [in papers].
- Section titles are not followed by a period.
Over the years, I've come to understand that consistency in writing is not only essential for improving my craft, but also for cultivating the strange and capricious creature known as inspiration.
“This sentence has five words. Here are five more words. Five-word sentences are fine. But several together become monotonous. Listen to what is happening. The writing is getting boring. The sound of it drones. It’s like a stuck record. The ear demands some variety. Now listen. I vary the sentence length, and I create music. Music. The writing sings. It has a pleasant rhythm, a lilt, a harmony. I use short sentences. And I use sentences of medium length. And sometimes, when I am certain the reader is rested, I will engage him with a sentence of considerable length, a sentence that burns with energy and builds with all the impetus of a crescendo, the roll of the drums, the crash of the cymbals–sounds that say listen to this, it is important.”
A way to set explicitly how a company is running. Here an example about an IT one.
Un dictionnaire proposant des mots plus inclusifs 👍
Summarize any content on the web - from articles to books - in a jiffy!
Generates hand-written style texts
Create a product advertisement from a product description.
- Conclusion
- Key arguments
- Detailed information
Ce blog illustre chaque billet avec des images d'un thème donné.
Le dernier publié Comment affronter un entretien technique des enfers ? utilise les images du dictateur de Corée du Nord. Ces illustrations fonctionnent bien et renforcent le storytelling.
Comment devenir riche en vendant des JPGs utilise des images du loup de wall street.
4 raisons de se lancer dans une relation de mentorat a des illustrations des films Rocky
An example of style guide for content
Impressive
The second lesson I have learned is that when I first sit down to write I must allow the flood of ideas to flow out of me onto the page without worrying about what is coming out. If I pause to correct grammar, spelling, or sentence structure, I risk losing sight of the vision that created the words in the first place.
One of the things that makes me happiest about running a self-hosted blog is that I can write whatever I want, and anyone can read it--assuming they can find it.
So true. I don't allow myself to write on my blog, putting much time on these readings on RSS feeds, then posting them on the shaarli.
Some users are not aware that by downloading RSS feeds literally every two minutes, they are hogging Internet bandwidth and wasting resources.
I am refreshing my RSS feeds or twice a day :/ I didn't they were such impatient people up there. Everything exist on the Internet though.
Personal website owners who endure may do so because they learn to view their work as a way of providing a needed service or information.
Example of lehollandaisvolant, ....
Perhaps we should focus less on the number of visitors we draw to our websites and more on our efforts to create something of value, something that will make others just a little wiser, just a little freer, or just a little happier.
That's why I don't even have a Mattomo instance
I suspect those whose websites endure the longest are those who find joy in coding, writing, and communicating with their readers.
Seems true to me too.
Knowing that I am not alone is a source of motivation for continued writing, not in the belief that by doing so I will change the world, but simply because I am encouraged to feel that someone should be writing about our shared concerns, someone who is not receiving a paycheck or a campaign contribution for doing so.
It is also a very easy way to share on the Internet. And this feeling to be able to reach so many people, or to make content available according to your own wishes is a great equanimity.
Retranscribe audio or video to text 👍
The very act of recording your actions and impressions is itself powerfully mnemonic, fixing the moment more durably in your memory so that it’s easier to recall in future, even if you never consult your notes. ‒ Cory Doctorow
Mhmhmhm I will read it when I will need to improve my english for sure !
Testomony and feedback after 100 posts written.
Here the tips I find relevant for myself:
*Write about the topic, even if it has been covered elsewhere. Your perspectives, experiences, and understanding are the unique bit. People want to read your work.
- Learn to identify the difference between constructive criticism and unproductive harassment. It’ll help you focus on what matters and not waste time and energy.
- Get comfortable getting rejected. While the sting never really goes away, you do grow a thicker skin.
- Read your writing out loud to yourself before publishing it.
- Read it out loud again.
Research has shown that the ideal line length is about 65 characters. Anywhere between 45 and 85 is generally seen as acceptable, in the context of a roman alphabet.
The solution:
.wrapper {
display: grid;
grid-template-columns:
1fr
min(65ch, 100%)
1fr;
}
.wrapper > * {
grid-column: 2;
}
.full-bleed {
width: 100%;
grid-column: 1 / 4;
}
ch is a unit, like px or rem. It corresponds to the width of the 0 character in the current font, for the specified font size.
The idea is not bad. BaaS is on its way actually: there is many editions (updated) of the same book.
The problem (especially in IT):
Well, I see books evolving the same way. Or, at least, non-fiction reference books. Think of all programming books published out there. With a few notable exceptions, most of them become obsolete soon after printing. Once the book gets out, the publisher pays off the original investment; the author receives royalties from every sale, which continues for a while. A few years later, the technology landscape has changed enough to justify publishing a whole new edition. But it is a considerable investment risk for all sides.
Leanpub and Gumroad are 2 platforms that encourage to update the contents of the books.
The deal is to write a little content of the book that is sold for nothing or nearly nothing. Then the writer see if there is enough value into adding content. The readers that have bought the book early will have access to the future content too.
An ode for the text:
- most stable & durable
- most flexible
- Pictures may be worth a thousand words, when there's a picture to match what you're trying to say.
- precisely controlled level of ambiguity, precision, context and elaborated content
- most efficient communication technology
- easily indexed, searched, translated
- it is asynchronous, compared, diffed, clustered, corrected, summarized, filtered algorithmically
- it permits multiparty editing, branching conversation, lurking, annotation, quoting, reviewing, struc
- most socially useful communication technology (in 1:1, 1:N, M:N)