Skip to main content
Advertisement
  • Loading metrics

Ten simple rules for writing a PLOS Computational Biology quick tips article

Introduction

Seventeen years have passed since Phil Bourne inaugurated the Ten Simple Rule (TSR) collection in PLOS Computational Biology (PLOS CB) with a paper entitled “Ten Simple Rules for Getting Published” [1]. At that time, the change in how we communicate sciences had already begun [2]: social media was blooming, the information deluge was ongoing, and the fear of missing information was anchored in each of us. The Ten Simple Rules collection filled a space in scientific publications where researchers eager to share their experiences, wisdom, and doubts could quickly do it using a colloquial narrative. The topics covered were broad themes in scientific practice, such as soft skills and career development, captured in a concise and quick-to-read format, something between a blog post and a scientific article.

This type of article attracted much interest from readers. In 2018, the collection reached the milestone of 1,000 Rules [3], and today this figure is above 250 papers (2,500 Rules!) [4]. With the increase of technical and scientific topics, in 2013, PLOS Computational Biology tried a new experience with a similar format—we introduced “Quick Tips” (QT) articles—with the attempt to make a clear distinction between the more specific and focused scientific activities and skills presented with resources, databases, and other tools in Quick Tips versus the broader themes presented in a Ten Simple Rules article.

“Ten Simple Rules for Writing a PLOS Ten Simple Rules Article” [5] explains the Ten Simple Rules concept, format, and reasoning very well and is still relevant today. Inspired by that article, we wrote this Ten Simple Rules paper intending to accomplish a similar task: explaining to our community what a Quick Tips article is about and how a Quick Tips article differs from a Ten Simple Rules article. The authors are the Section Editors of the Education Collection (PP and BFFO), which encompasses the Quick Tips, and the Section Editors of the Ten Simple Rules Collection (RS and SM). In our work at PLOS CB, we are routinely deliberating the merits of a submission being a Ten Simple Rules or a Quick Tips, and for this reason, we decided to put these Ten Simple Rules about Quick Tips together. Historically, several papers were submitted as Ten Simple Rules that should have been Quick Tips. Still, we will refrain from commiserating about things not done but rather present what we hope will be a clear distinction that will make it obvious in the future why articles are best considered as Quick Tips versus Ten Simple Rules (or vice-versa). We hope and plan for this present article to be helpful for future writers willing to contribute to this collection and to help clarify the differences between Ten Simple Rules and Quick Tips.

Why is this not a Quick Tips article but a Ten Simple Rules article, and why are we not as endearing as Dashnow, Lonsdale, and Bourne were in doing a “Ten Quick Tips for Writing a PLOS Quick Tips Article”? The reason is simple. As stated in Rule 1, this is a soft-skills article: it aims to explain how best to write a particular type of manuscript for PLOS. Thus, it is not a Quick Tips but a Ten Simple Rules article. In Fig 1, we summarize the Ten Simple Rules we are presenting.

thumbnail
Fig 1. Summary of the Ten Simple Rules presented in this manuscript.

https://doi.org/10.1371/journal.pcbi.1011689.g001

Rule 1: Give tips, not rules

Quick Tips are for guiding readers on developing scientific and technical skills on using databases, resources, computational or data analysis methods and tools. Quick Tips can teach how to analyze network data [6], use the Gene Ontology (GO) [7], or use deep learning in biology [8]. They have a specific educational perspective. With a Quick Tips article, you drive the reader towards learning and applying what they are learning. They are quick tips, not simple rules. As such, each tip needs to inform the reader about a different aspect of the overall problem (computational) biologists want to get better at.

Ten Simple Rules are more to develop soft skills, career promotion/advancement (how to organize a scientific conference [9], write your cover letter [10], write a literature review [11], etc.), or other broad issues in scientific practice (e.g., models for successful collaboration [12,13], developing scientific communities [14], or practicing inclusive science [15,16]).

Rule 2: Minimize overlap and amplify new insights

When putting together a Quick Tips article, ensure there is no redundancy with other Quick Tips or other educational articles. The Quick Tips articles have yet to become as famous as its sister collection, Ten Simple Rules, which counts 255 articles so far [4]. Still, plenty of valuable Quick Tips and education articles in PLOS and other journals may have treated the same topic as yours. But if you think you have a different or unique perspective on the same topic, do not forget to reference all those relevant to your Quick Tips in your manuscript and explain what makes yours unique. Paraphrasing Dashnow, Lonsdale, and Bourne’s wise advice in Rules 7 and 9: summarize, cite, and write well [5].

Rule 3: Make each tip a declarative statement, not simply a passing thought

The title of the tip is essential, and it needs to state a tip. At a glance, the reader must understand your main key message, which must simultaneously be persuasive and noteworthy.

When you declare a tip, make sure it is a statement and to the point. You are providing a unit of advice to your readers to perform (or not) specific tasks, and as such, you want to avoid misinterpretations. By making your tips declarative statements, you can ensure they are unambiguous and leave no room for interpretation or confusion. If you provide an opinion, provide evidence to sustain your point of view and convince your readers of your argument.

Rule 4: Be concise and to the point

Less is more. Quick Tips papers are currently part of the PLOS Computational Biology Education collection [17,18], and as for any article in this collection, a Quick Tips article is about 2,000 to 2,500 words [19]. From a pedagogical perspective, some educational models support the value of being concise (e.g., Miller) [20], which we support in the PLOS Education collection. However, there is some flexibility here. The story of your manuscript may be more important than the length of the manuscript you are submitting. Word limits provide boundaries and are a great tool to make you reflect on the primary key messages you want to deliver. You cannot neglect good writing practices because Quick Tips papers are short. Make sure to read and apply the excellent rules provided by Ehrhart and Evelo in [21] to your manuscript.

Rule 5: Be creative on the number of tips

Another important difference between the Quick Tips articles and Ten Simple Rules articles is that you are not restricted to 10 tips, as opposed to Ten Simple Rules, where 10 is one of the rules [5]. Please feel free to do so if it makes sense to have 8, 9, or 13 tips. As we see in Fig 2, the number of tips we have seen in Quick Tips articles ranges from 7 to 15.

thumbnail
Fig 2. Distribution of the number of tips presented in the 36 Quick Tips articles from 2020–09 to 2023–10 [22].

https://doi.org/10.1371/journal.pcbi.1011689.g002

Rule 6: Make sure your tips are presented logically and that there are no gaps

Quick Tips are like recipes, like a procedural order of execution of tasks for a given topic. They should follow at least a logical order. Consider them a “sorted checklist” that your readers will follow and apply. As for a recipe, you can’t miss any ingredients or procedures, as the result may not be as expected.

Rule 7: Be visual

Using images in a manuscript can help to make the content more accessible, engaging, and visually appealing to readers, and as the adage says: “an image is worth a thousand words.” Images can help visualize or clarify a concept or idea you are discussing in the text and provide evidence for your claims in the tips. As Weinstein and Sumeracki, two cognitive scientists, say “Pictures are usually remembered better than words, and can provide additional memory cues” and thus help learning and understanding [23]. Thus, we recommend Quick Tips authors incorporate a figure summarizing and illustrating their tips (Fig 1). By the way, we recommend the same for Ten Simple Rules authors.

Alternatively, suppose you do not use a figure. In that case, we recommend including a table in the introduction that declares the tips in a summarized way and allows the reader to get an overview of the text to follow.

For all images presented on the web or within a publication, it is important to have some alternative text (Alt-Txt) for visually impaired readers [24,25] and also to consider a color palette that color blind people will be able to interpret [26].

Rule 8: Be an empathic instructor

Quick Tips are educational articles and thus serve to teach scientific or technical skills to your readers. Be mindful of your language (avoid jargon, define terms), and be specific, clear, and concise. Quick Tips need to be written as a tutorial used by a classroom teacher or a reader to learn from you. Your ambition: be the reference article about teaching that topic.

You can write a Quick Tips article alone, but collaborating is better. Seven of the 10 most cited PLOS CB Quick Tips articles have three or more authors [22]. Your tips should be messages from a community of instructors you represent for a community of readers. When you write a Quick Tips article, you (singular, but hopefully plural) speak as experts with an aura of knowledge, authority, and empathy for your readers.

Rule 9: Ask for feedback before writing the manuscript

Well ahead of starting to work on that manuscript, outline the tips, and send this together with a summary to ploscompbiol@plos.org. We will happily comment and guide you before you spend too much time writing a full manuscript. One common question where people still need clarification: should it be a Ten Simple Rules or a Quick Tips submission? If you are unsure after reading this publication, please contact the section editors or PLOS Computational Biology directly (ploscompbiol@plos.org). As always, it is also a good idea to consult and share with colleagues before you submit any article.

Rule 10: Help the editors do a great job

As for all PLOS Computational Biology articles, we send the submissions for peer review, so don’t forget to include many suggestions for potential reviewers (5 or 6 is ideal) from which the section editors may select. Identify experts within your field who can serve as independent, objective reviewers and are free from competing interests. At the same time, since Quick Tips are for educational purposes and have a particular format (not to be confused with usual research papers), these experts should be aware of the Quick Tips format. They should also have an open and teaching mindset. Remember that suggesting recent collaborators or other researchers at your institution is inappropriate, as it would be for any other manuscript submission.

Conclusions

Ten Simple Rules and Quick Tips are fundamentally similar types of articles. Except for Rules 1 and 5, all the other rules in this manuscript can also apply to the Ten Simple Rules papers. If we were to give you extra and particular advice, it would be: never underestimate Rule 2. Minimize overlap and amplify new insights.

Ten Simple Rules, Quick Tips, and the Education collections already have plenty of exciting and insightful manuscripts, which are excellent resources for teaching and learning. But there is always a place for your preferred topic; we welcome and look forward to your new ideas. We endeavor to get back to you in a timely way.

As a way to say “thank you,” we want to remind new potential authors of the Quick Tips and Ten Simple Rules articles that these articles (which also include all in the PLOS CB Education collection) are what is referred to as “Front Matter,” and PLOS has no publication charges (no APC) on Front Matter papers. Like all PLOS articles, Quick Tips articles are fully Open Access (Gold) and are free to you as the author (Open Access Diamond). Front matter is like the author and PLOS giving to the community, so there are no charges.

Acknowledgments

The authors acknowledge the help of Patrick Graf for the graphic design of Fig 1.

References

  1. 1. Bourne PE. Ten Simple Rules for Getting Published. PLoS Comput Biol. 2005;1:e57. pmid:16261197
  2. 2. The History of Communications. [cited 2023 Aug 28]. Available from: https://world101.cfr.org/global-era-issues/globalization/two-hundred-years-global-communications.
  3. 3. Bourne PE, Lewitter F, Markel S, Papin JA. One thousand simple rules. PLoS Comput Biol. 2018;14:e1006670. pmid:30571692
  4. 4. PLOS Comp. Bio. Ten Simples Rules collection. [cited 2023 Aug 28]. Available from: https://shrtm.nu/hpX.
  5. 5. Dashnow H, Lonsdale A, Bourne PE. Ten Simple Rules for Writing a PLOS Ten Simple Rules Article. PLoS Comput Biol. 2014;10:e1003858. pmid:25340653
  6. 6. Miele V, Matias C, Robin S, Dray S. Nine quick tips for analyzing network data. PLoS Comput Biol. 2019;15:e1007434. pmid:31856181
  7. 7. Blake JA. Ten Quick Tips for Using the Gene Ontology. PLoS Comput Biol. 2013;9:e1003343. pmid:24244145
  8. 8. Lee BD, Gitter A, Greene CS, Raschka S, Maguire F, Titus AJ, et al. Ten quick tips for deep learning in biology. PLoS Comput Biol. 2022;18:e1009803. pmid:35324884
  9. 9. Corpas M, Gehlenborg N, Janga SC, Bourne PE. Ten Simple Rules for Organizing a Scientific Meeting. PLoS Comput Biol. 2008;4:e1000080. pmid:18584020
  10. 10. Tomaska L, Nosek J. Ten simple rules for writing a cover letter to accompany a job application for an academic position. PLoS Comput Biol. 2018;14:e1006132. pmid:29851981
  11. 11. Pautasso M. Ten Simple Rules for Writing a Literature Review. PLoS Comput Biol. 2013;9:e1003149. pmid:23874189
  12. 12. Knapp B, Bardenet R, Bernabeu MO, Bordas R, Bruna M, Calderhead B, et al. Ten Simple Rules for a Successful Cross-Disciplinary Collaboration. PLoS Comput Biol. 2015;11:e1004214. pmid:25928184
  13. 13. Maestre FT. Ten simple rules towards healthier research labs. PLoS Comput Biol. 2019;15:e1006914. pmid:30973866
  14. 14. Michaut M. Ten Simple Rules for Getting Involved in Your Scientific Community. PLoS Comput Biol. 2011;7:e1002232. pmid:22046114
  15. 15. Perez-Lopez E, Gavrilova L, Disla J, Goodlad M, Ngo D, Seshappan A, et al. Ten simple rules for creating and sustaining antiracist graduate programs. PLoS Comput Biol. 2022;18:e1010516. pmid:36227841
  16. 16. Guevara-Ramírez P, Ruiz-Pozo VA, Cadena-Ullauri S, Salazar-Navas G, Bedón AA, V-Vázquez JF, et al. Ten simple rules for empowering women in STEM. PLoS Comput Biol. 2022;18:e1010731. pmid:36548242
  17. 17. Lewitter F. Welcome to PLoS Computational Biology “Education”. PLoS Comput Biol. 2006;2:e7.
  18. 18. Fox JA, Ouellette BFF. Education in Computational Biology Today and Tomorrow. PLoS Comput Biol. 2013;9:e1003391. pmid:24348234
  19. 19. PLOS Computational Biology—Other article types. [cited 2023 Oct 29]. Available from: https://journals.plos.org/ploscompbiol/s/other-article-types.
  20. 20. Miller GA. The magical number seven, plus or minus two: some limits on our capacity for processing information. 1956. Psychol Rev. 1994;101:343–352. pmid:8022966
  21. 21. Ehrhart F, Evelo CT. Ten simple rules to make your publication look better. PLoS Comput Biol. 2021;17:e1008938. pmid:34014916
  22. 22. PLOS Comp. Bio. Quick Tips collection. [cited 2023 Oct 29]. Available from: https://shrtm.nu/hq1.
  23. 23. Weinstein Y, Sumeracki M, Caviglioli O. Understanding How We Learn: A Visual Guide. Routledge, Taylor & Francis Group. 2018.
  24. 24. Guide to image descriptions. [cited 2023 Oct 29]. Available from: https://www.accessiblepublishing.ca/a-guide-to-image-description/.
  25. 25. How to Write Alt Text and Image Descriptions for the visually impaired. [cited 2023 Oct 29]. Available from: https://www.perkins.org/resource/how-write-alt-text-and-image-descriptions-visually-impaired/.
  26. 26. Okabe M, Ito K. Color Universal Design (CUD)—How to make figures and presentations that are friendly to Colorblind people -. 2008. Available from: https://jfly.uni-koeln.de/color/.