ads
write articles that people want to read.
ads
Here are some recommendations that the In Plain English team considers best practices when writing articles that readers find engaging and easy to read.
ads
Please give your article an appropriate title and subtitle. Keep your wording simple and persuasive. When in doubt, ask yourself, "Do you think the title is interesting enough to keep reading this article?"ads
Don't create weird formatting for headings and subheadings. Keep them simple and make sure each heading/subheading in your article is formatted consistently. If you want to number your headings, see this example:
ads
1. This is a good headline
2. This is also a good headline
1 : > This is a bad headline
2 #: This is also a bad headline
Half-baked items look bad. If you can't take the time to write an article with proper structure, punctuation, spelling, and formatting, why do you think someone else will spend a lot of time reading it?
2. This is also a good headline
1 : > This is a bad headline
2 #: This is also a bad headline
Half-baked items look bad. If you can't take the time to write an article with proper structure, punctuation, spelling, and formatting, why do you think someone else will spend a lot of time reading it?
ads
Take pride in your work. Your writing is an extension of you as a person, especially in a professional context. If you're writing about code, chances are you're eager to use the software or have already used it. The words you write speak for themselves, so express yourself well!
Capitalize each sentence.
Capitalize each sentence.
ads
For articles with a read time of 2-3 minutes, do they cover everything the article needs and what readers expect? has been shown to be effective.
If you're not sure your English is perfect or near perfect, try editing your article using your writing software with the language set to English (UK) or English (US). Try writing articles in Google Docs. If you chose Google Docs, you have the language set to English (File > Language) and spelling and grammar checking enabled (Tools > Spelling and Grammar) Please Confirm.
If you're not sure your English is perfect or near perfect, try editing your article using your writing software with the language set to English (UK) or English (US). Try writing articles in Google Docs. If you chose Google Docs, you have the language set to English (File > Language) and spelling and grammar checking enabled (Tools > Spelling and Grammar) Please Confirm.
ads
Some people swear Grammarly. Grammarly is a great tool for improving the quality of content, but too many authors claim to have used Grammarly to review their work, even though it still contains simple errors. increase. Even if you are confident in your English, we encourage you to use these tools.
ads
If you have doubts about any of her three points above, try rereading her article. Consider whether you still think your article is good enough for others to read. Hope this is it! 🙂
Don't overuse emojis!
Don't overuse emojis!
ads
Do not overuse GIFs and memes.
Do not use multiple exclamation points. You don't write comics! But if you're writing a manga, you might as well just say "Ahhh!!!".
If the sentence you are writing is not a question, don't put a question mark at the end.
Do not use multiple exclamation points. You don't write comics! But if you're writing a manga, you might as well just say "Ahhh!!!".
If the sentence you are writing is not a question, don't put a question mark at the end.
ads
Don't use ellipses (...) unless you really know how and when to use them. If you plan to use them, make sure you only use 3 dots, not 2, not 4, not 5.
Write the names of things in correct capital letters. For example, "JavaScript" is written like this. Not "Javascript" or "Javascript" or anything like that.
Write the names of things in correct capital letters. For example, "JavaScript" is written like this. Not "Javascript" or "Javascript" or anything like that.
ads
Are you writing about topics that others have covered hundreds of times? Sometimes we want to write about new things we learn. Are you really bringing something new to the topic, or are you just trying to show that you know your stuff? Consider this carefully and design your article accordingly.
ads
Capitalize each sentence. Yes, we've mentioned this before, but you'd be surprised how many articles we read didn't.
ads
Do not put a space between the last letter and the punctuation marks. Example: This sentence is incorrect. But this is!
ads
Are you 100% sure you know and understand the rules of English punctuation? If not, be sure to read this short guide: https://dictionary.cambridge. org/grammar/british-grammar/punctuation
ads
If you have a website, business, newsletter or other call to action, get involved in subtle advertising. Remember, people use AdBlockers for a reason.
Sentences starting with supercapital letters look silly. See how this looks out of place now. Stop using them.
Do not use these either.
Sentences starting with supercapital letters look silly. See how this looks out of place now. Stop using them.
ads
Don't use it anymore.Do not use these either.
ads
Do not create articles that do not contain at least one image that media can use as an attachment. Articles without high resolution images are less likely to be clicked by potential readers.ads
If the article consists of multiple parts, please link to the other parts of each article so that the reader can follow the entire series.
Variable names, file paths, URLs, directory names, class names and values must be formatted like this. Should not be bold or italicized unless the code is formatted for emphasis
Variable names, file paths, URLs, directory names, class names and values must be formatted like this. Should not be bold or italicized unless the code is formatted for emphasis
ads
You can format something by highlighting it and pressing the ` key on your keyboard. Anything that is not pure code, such as filenames. You can also bold example.js if you prefer. Whatever you decide to do, make sure your articles are consistent.
ads
At the end of your post, please consider including a resources section listing useful sources of information cited in your post.
ads
Please take the time to tag your articles meaningfully. If your article is about React Hooks, consider tagging it with the core topics that make up your article: "React", "JavaScript", "Programming", and two other appropriate tags. Don't bother tagging things like "Reacthooks". Because people don't search on Medium.
ads
Please complete the article. There is nothing more bizarre than seeing an article that ends randomly without any natural breaks. Even if it says "This is done. I hope this helps. Thanks for reading". By the way, you can steal it!
ads
Here are some recommendations that the In Plain English team considers best practices when writing articles that readers find engaging and easy to read.
ads
Please give your article an appropriate title and subtitle. Keep your wording simple and persuasive. When in doubt, ask yourself, "Do you think the title is interesting enough to keep reading this article?"ads
Don't create weird formatting for headings and subheadings. Keep them simple and make sure each heading/subheading in your article is formatted consistently. If you want to number your headings, see this example:
ads
1. This is a good headline
2. This is also a good headline
1 : > This is a bad headline
2 #: This is also a bad headline
Half-baked items look bad. If you can't take the time to write an article with proper structure, punctuation, spelling, and formatting, why do you think someone else will spend a lot of time reading it?
2. This is also a good headline
1 : > This is a bad headline
2 #: This is also a bad headline
Half-baked items look bad. If you can't take the time to write an article with proper structure, punctuation, spelling, and formatting, why do you think someone else will spend a lot of time reading it?
ads
Take pride in your work. Your writing is an extension of you as a person, especially in a professional context. If you're writing about code, chances are you're eager to use the software or have already used it. The words you write speak for themselves, so express yourself well!
Capitalize each sentence.
Capitalize each sentence.
ads
For articles with a read time of 2-3 minutes, do they cover everything the article needs and what readers expect? has been shown to be effective.
If you're not sure your English is perfect or near perfect, try editing your article using your writing software with the language set to English (UK) or English (US). Try writing articles in Google Docs. If you chose Google Docs, you have the language set to English (File > Language) and spelling and grammar checking enabled (Tools > Spelling and Grammar) Please Confirm.
If you're not sure your English is perfect or near perfect, try editing your article using your writing software with the language set to English (UK) or English (US). Try writing articles in Google Docs. If you chose Google Docs, you have the language set to English (File > Language) and spelling and grammar checking enabled (Tools > Spelling and Grammar) Please Confirm.
ads
Some people swear Grammarly. Grammarly is a great tool for improving the quality of content, but too many authors claim to have used Grammarly to review their work, even though it still contains simple errors. increase. Even if you are confident in your English, we encourage you to use these tools.
ads
If you have doubts about any of her three points above, try rereading her article. Consider whether you still think your article is good enough for others to read. Hope this is it! 🙂
Don't overuse emojis!
Don't overuse emojis!
ads
Do not overuse GIFs and memes.
Do not use multiple exclamation points. You don't write comics! But if you're writing a manga, you might as well just say "Ahhh!!!".
If the sentence you are writing is not a question, don't put a question mark at the end.
Do not use multiple exclamation points. You don't write comics! But if you're writing a manga, you might as well just say "Ahhh!!!".
If the sentence you are writing is not a question, don't put a question mark at the end.
ads
Don't use ellipses (...) unless you really know how and when to use them. If you plan to use them, make sure you only use 3 dots, not 2, not 4, not 5.
Write the names of things in correct capital letters. For example, "JavaScript" is written like this. Not "Javascript" or "Javascript" or anything like that.
Write the names of things in correct capital letters. For example, "JavaScript" is written like this. Not "Javascript" or "Javascript" or anything like that.
ads
Are you writing about topics that others have covered hundreds of times? Sometimes we want to write about new things we learn. Are you really bringing something new to the topic, or are you just trying to show that you know your stuff? Consider this carefully and design your article accordingly.
ads
Capitalize each sentence. Yes, we've mentioned this before, but you'd be surprised how many articles we read didn't.
ads
Do not put a space between the last letter and the punctuation marks. Example: This sentence is incorrect. But this is!
ads
Are you 100% sure you know and understand the rules of English punctuation? If not, be sure to read this short guide: https://dictionary.cambridge. org/grammar/british-grammar/punctuation
ads
If you have a website, business, newsletter or other call to action, get involved in subtle advertising. Remember, people use AdBlockers for a reason.
Sentences starting with supercapital letters look silly. See how this looks out of place now. Stop using them.
Do not use these either.
Sentences starting with supercapital letters look silly. See how this looks out of place now. Stop using them.
ads
Don't use it anymore.Do not use these either.
ads
Do not create articles that do not contain at least one image that media can use as an attachment. Articles without high resolution images are less likely to be clicked by potential readers.ads
If the article consists of multiple parts, please link to the other parts of each article so that the reader can follow the entire series.
Variable names, file paths, URLs, directory names, class names and values must be formatted like this. Should not be bold or italicized unless the code is formatted for emphasis
Variable names, file paths, URLs, directory names, class names and values must be formatted like this. Should not be bold or italicized unless the code is formatted for emphasis
ads
You can format something by highlighting it and pressing the ` key on your keyboard. Anything that is not pure code, such as filenames. You can also bold example.js if you prefer. Whatever you decide to do, make sure your articles are consistent.
ads
At the end of your post, please consider including a resources section listing useful sources of information cited in your post.
ads
Please take the time to tag your articles meaningfully. If your article is about React Hooks, consider tagging it with the core topics that make up your article: "React", "JavaScript", "Programming", and two other appropriate tags. Don't bother tagging things like "Reacthooks". Because people don't search on Medium.
ads
Please complete the article. There is nothing more bizarre than seeing an article that ends randomly without any natural breaks. Even if it says "This is done. I hope this helps. Thanks for reading". By the way, you can steal it!
ads

0 Comments