Bookmarks tagged [writing]
https://github.com/kylelobo/The-Documentation-Compendium
Various README templates & tips on writing high-quality documentation that people want to read.
- tags: documentation, writing, readme
source code
https://www.writethedocs.org/guide/
This guide gathers the collective wisdom of the Write the Docs community around best practices for creating software documentation.
- tags: documentation, writing
- source code
https://github.com/TalAter/awesome-book-authoring#readme
📚 A collection of awesome resources for technical book authors - TalAter/awesome-book-authoring
- tags: awesome-list, book, authoring, writing
- source code
http://www.plainenglish.co.uk/drivel-defence-text.html
This tools numbers to words in your sentences in a nice report.
Plain English Campaign is an independent group fighting for plain English in public communication. We oppose gobbledygook, jargon and l...
This is a tool that tries to calculate the Gunning Fog Index. It is a weighted average of the number of words per sentence, and the number of long words per word. An interpretation is that the text ca...
http://www.plainenglish.co.uk/files/alternative.pdf
If you find yourself about to write, type or dictate a word you wouldn’t use in every day conversation, look it up in the A to Z. You should find a simpler alternative. Often there will be a choice of...
CAN YOU EXPLAIN A HARD IDEA USING ONLY THE TEN HUNDRED MOST USED WORDS? IT'S NOT VERY EASY. TYPE IN THE BOX TO TRY IT OUT.
Hemingway makes your writing bold and clear. It's like a spellchecker, but for style. It makes sure that your reader will focus on your message, not your prose.
https://www.youtube.com/watch?v=3AaEvnVjrRc&feature=youtu.be
Writing a great cover letter starts with understanding its purpose. A cover letter’s job isn’t to get you the job. It’s to get you an interview.
https://en.wikipedia.org/wiki/Inverted_pyramid_(journalism)
The widest part at the top represents the most substantial, interesting, and important information that the writer means to convey, illustrating that this kind of material should head the article, whi...
- tags: writing
http://www.ambysoft.com/books/bookWriting.html
The goal of this page is to share my hard-won experiences writing books. The bad news is that writing a book is hard work and frankly it can be very difficult to break into the publishing industry. ...
- tags: writing
https://www.linkedin.com/pulse/20140818005915-47802955-how-to-write-an-awesome-introduction-for-your...
So many writers focus on the body of their book – the key points they’ll use to express their argument, which case studies would work, which experts to quote, etc. – that they forget about their intro...
- 📆 published on: 2014-08-18
- tags: writing
https://johnresig.com/blog/programming-book-profits/
As I begin working on my second book I’ve gone back and realized that there’s a lot of things that I wish I knew before I started writing my first book way back in March of 2006.
- tags: writing
http://iamleeg.blogspot.ch/2010/04/on-writing-book.html
This post is about the author's experiences writing a book, not the book material itself.
- 📆 published on: 2010-04-02
- tags: writing
A manifesto for the simple scribe – my 25 commandments for journalists | Tim Radford | Science | The Guardian
https://www.theguardian.com/science/blog/2011/jan/19/manifesto-simple-scribe-commandments-journalist...
Former Guardian science editor, letters editor, arts editor and literary editor Tim Radford has condensed his journalistic experience into a handy set of rules for aspiring hacks
https://www.dorisandbertie.com/goodcopybadcopy/2016/10/07/culture-shapes-way-write/
In Anglo-Saxon cultures such as the UK, the US and Australia, the burden is on the writer to make their meaning clear.
In these cultures, if a reader fails to understand what a writer is trying to sa...