萝莉社官网

Skip to Content Skip to Footer

Writing Clarity Calculator

Source: Warren Nooshin L., Matthew Farmer, Tianyu Gu, Caleb Warren, 鈥,鈥&苍产蝉辫;Journal of Marketing.

Do you want your research to make an impact? If so, readers will need to understand your writing. Unfortunately, most academic writing is difficult to understand. Worse yet, most scholars don鈥檛 realize when their writing is unclear. As scholars, we suffer from a 鈥渃urse of knowledge,鈥 which prevents us from realizing that readers do not understand our research as well as we do.

Knowledge, or familiarity with our own research, prompts three practices that make academic writing difficult to understand: abstraction, technical language, and passive writing. Instead of describing 鈥渟pilled coffee鈥 and 鈥渙ne-star Yelp reviews,鈥 we discuss 鈥渆xpectation-disconfirmation鈥 and 鈥減ost-purchase behavior.鈥 Instead of writing 鈥淲e studied how liberal and conservative consumers respond when brands post polarizing messages on social media,鈥 we write, 鈥淭he interactive effects of ideological orientation and corporate sociopolitical activism on owned media engagement were studied.鈥

When our writing is abstract, technical, and passive, readers struggle to understand it. And when readers don鈥檛 understand our article, they are unlikely to read it, much less absorb it and be influenced by its ideas.

Fortunately, we can overcome the curse of knowledge by knowing how and when to rely on abstraction, technical, and passive writing. To that end, our research led us to develop two tools鈥攁 website () and a tutorial (Web Appendix B in the paper)鈥攖o help scholars recognize and repair unclear writing so their research can make a larger impact in the marketplace of ideas.

Website Description:

To use the website:

  1. Copy and paste all or a section of your writing into the text box.

  2. The bots on this site will analyze the text and tell you:

    • how concrete your writing is (on a scale from 1 to 5)

    • how many examples you included per page (assuming 844 words per page)

    • how frequently the words you use appear on the internet (relative to 鈥渢he鈥, the most frequently used word on the internet)

    • the percentage of your sentences that use active voice.

  3. For details on how we calculated these scores, see our .

The website will also tell you how your writing compares to the articles published in premier marketing journals between 2000 and 2010. The website will compare your writing to (a) the front-end of published articles (text before the method section), and (b) the entire text of the published articles (including the references).

The website uses Python 3.7 () as the programming language, Flask () as the web framework, and Gunicorn () as the http server. It is hosted on Amazon Elastic Compute Cloud () and the platform is 64-bit Amazon Linux 2 ().

Web Appendix B

We created a tutorial to help scholars learn (a) how to recognize abstract, technical, and passive writing, (b) why and when to use these practices, and (c) how to avoid overusing them.