Preparing a manuscript for publication: A user-friendly guide
Bibliographic record
Abstract
“Whatever you dream, begin it, for boldness has power,magic and genius in it.”– GoetheAll of us are connected to medical journals, whether it isthrough reading, writing, reviewing or suggesting topics tobe addressed. The purpose of the present commentary is toencourage potential new writers by suggesting ways tosmooth the sometimes bumpy path between having an ideafor a paper and reaching the finish line of publication.While there are many reasons for writing a paper – such asto share clinical and research observations; to submit one’sobservations, ideas and conclusions to critical evaluation bypeers; to provide guidance to improve the health care of chil-dren and youth; to advocate for policy change; and to supportpersonal academic advancement – writing also provides anexcellent learning experience, promotes critical thinking andenhances the ability to be more concise in written communi-cations. These all help to make one a better physician.STEP 1: FINDING THE TIME TO THINKTo write, one needs something to say, which requires think-ing time. There are many times in the day that are ideal forthinking, such as while doing rote tasks that do not requireone’s full attention (eg, riding the bus or walking to work,shovelling snow, gardening or taking a shower). Develop thehabit of using some of these times to think about writing.What to think about?In preparing to write, think about the answers to the fol-lowing questions:• What do you want to say about this topic – what isyour key message?• Why do you care about this?• Who is the intended audience, and therefore, whatformat and type of journal should this piece besubmitted to?• Why would this audience be interested?• Who might want to work on this paper with you?Capture these ideas in a notebook, a file folder or your per-sonal digital assistant, or by sending e-mails to yourself.Review and refine the answers. Regularly review this ‘ideasfile’. Once your ideas are focused, you are ready to write.STEP 2: FINDING THE TIME TO WRITE‘Five minutes here and five minutes there’ does not workfor writing. You need ‘real’ time set aside to write. Thesolution: schedule time for writing by making an appoint-ment in your weekly planner – a one- or two-hour blockonce or twice a week.When and where to write?Writing is a complex task that requires you to be at yourbest. Are you a morning person or one who works best atnight? Do you need a warm-up period (ie, a preliminarytask, perhaps dictating your case notes) to set you up towrite or are you a quick study? What type of environmentdo you find most conducive to a complex task – a quietroom, background music, a cup of tea, etc? To minimize dis-tractions and interruptions while writing, where is the bestplace for you to write – your workplace office, your homeoffice or the library? A ‘do not disturb’ sign may help.Getting startedYou have been using your thinking time and your ideas folder.You have writing time scheduled. The next step is to find a‘personal editor’ and a ‘writing buddy’. The former is afriend or colleague who already is a successful writer andwho is willing to work with you on your writing. This per-son does not need to be physically located near you becausemuch can be done by e-mail. Your ‘writing buddy’ is some-one like yourself who also wants to write, and needs supportand encouragement to do this.Now select your best idea and set yourself a deadline toget your first draft done. Focus on your key message. Write abrief overview to organize your thoughts and arguments.This can form the basis of the later abstract and will help toguide your writing. Remember the AIMRAD format:abstract, introduction, methods, results and discussion. Writeyour first draft. Ensure that you focus on your key message(s).Select your journal for first submission (see below).Discuss your first draft with your writing buddy. Makerevisions. Show your second draft to your personal editor.Rewrite and refine. Be as succinct and clear as possible.Tables offer a means to present a large volume of data in aconcise and readable form. Thoughtful and critical review ofthe manuscript by all authors, and writing and rewritingseveral times before submission are critical. Many authors
Fetched live from OpenAlex and de-inverted. Abstracts are not stored in this database: the inverted indexes are 8.6 GB of the frame’s 9.3 GB of text, and the host has 13 GB free.
How this classification was reachedexpand
Full frame machine prediction
Teacher imitationNot calibrated prevalence, not ground truth. Human validation pending. The Gemma side is a direct model label for every work in the frame, read from the title-only record. The Codex side is a classifier learned from the 10,348 direct Codex labels and calibrated to design-weighted sample rates; fields without enough sample support carry no Codex call. Candidate is the union of the two sides; consensus is their intersection. These outputs are machine_predicted_unvalidated and are not human labels.
Distilled classifier scores by category (both heads)
| Category | Codex | Gemma |
|---|---|---|
| Metaresearch | 0.031 | 0.117 |
| Meta-epidemiology (narrow) | 0.004 | 0.003 |
| Meta-epidemiology (broad) | 0.006 | 0.003 |
| Bibliometrics | 0.009 | 0.006 |
| Science and technology studies | 0.002 | 0.003 |
| Scholarly communication | 0.010 | 0.010 |
| Open science | 0.004 | 0.006 |
| Research integrity | 0.005 | 0.009 |
| Insufficient payload (model declined to judge) | 0.571 | 0.467 |
Machine scores (provisional)
The two teacher heads of the student model, read on this work. A score orders the frame for review; it never asserts a category, and the validation status ships verbatim with every row.
Baseline scores from an immature model (maturity gate not passed, 7 training rounds). Scores rank; they never assert a category.
score_only:v0-immature-baseline · verbatim from the scoring run: score_only means the number may rank works, and no category label ships from itClassification
machine, unvalidatedMachine predicted; a candidate call from one source (direct Gemma or distilled Codex), not a consensus.
How this classification was reached, model by model and score by score, is at the end of the page under "How this classification was reached".