The Nutrition Press

Writing Guide

This guide outlines the guidelines for writing and requirements expected of articles at The Nutrition Press.

Communication

The Editorial Comments area of a post is where the majority of post-related communication occurs. This allows Authors and Editors to keep a record of feedback and discussion all in one convenient place. Editors will always comment a record of their changes to the purpose of Author self-education and quick appraisal of future and past article editing.
Quality of writing is not an expression of intelligence. We do not expect Authors to submit flawless articles. It is expected, that Authors take note of past feedback and pay due attention to the format, style, spelling and grammar of their valued works.

Website specific grammar

  • Avoid oxford commas. … , and
  • Single carriage returns between paragraphs.
  • No manual indentation of paragraphs.
  • Paragraphs should be like porridge….not too long, not too short. Just right.

Statuses

Online publishing at the Nutrition Press requires the orchestration of many Authors and Editors; each with their own busy schedules! The status of an article allows Editors to quickly assess the progression of article flow.

  • Pitch – These are ideas for articles. Anyone can ‘pitch’ an idea by creating a new post.
  • Assigned – When an article is ‘assigned’ to an Author they should take some time to plan their approach. Preliminary research may help at this stage. These ideas will be then discussed either at the monthly meetings or with an Editor to develop the argument. This process allows deeper development of an Author’s idea and allows Editors to link articles and topics between many Authors.
  • Draft – When an Author begins the writing process, they should change the status to ‘Draft’. This signals that the article is in development and notifies a free and private space to develop their story.
  • Pending needs editWhenever an Author has finished writing and the article is ready for review, change the status to ‘Pending – needs edit’. This will automatically notify the editorial team.
    – If an article was reviewed and requires further changes, the status will be changed back to ‘Draft’. When the changes have been made, changing the status to ‘Pending – needs edit’ will again automatically notify the editorial team.
  • In Review – These articles are currently under the attention of an Editor.
  • Hold / Reserve – These articles are either ready to publish or set aside for later development. Creating a buffer of ready-to-publish articles allows The Nutrition Press to accommodate the reality of a volunteer-driven Authorship. If Authors become sick or just busy (with good reason) we can maintain our article output and readership.

Referencing

At The Nutrition Press, we use a variation on the Vancouver style of referencing. The points below summarise the specific changes and compromises  that we have made to make our articles best suited to online-publishing.

  • The Nutrition Press uses software to automatically style and order its references. This requires references to be made in-text and encapsulated in double square-brackets.
  • No space between reference double-square brackets and text or punctuation-period ( . ).
  • References in double-square brackets should consistently be in normal style, never italics or bold.
  • For Journal articles sourced online, they will be referenced in the format of paper journals. If a hyperlink to the article source is desired, it should be placed as a DOI link after the normal reference.
  • For websites, an appropriate and relevant phrase should be hyperlinked directly. These references, in the majority of cases, need not be listed in full reference format.
  • When mentioning another source (e.g. pdf, open access journal) that is available on the Internet, it is encouraged to provide a hyperlink over a relevant phrase. Sharing is caring! Links are the life-blood of a website and are encouraged to improve reader-experience as well as our own website’s online presence. With few exceptions, hyperlinks should not be listed by their full address on this web-format.
  • It’s easy to make small errors in formatting with referencing. ‘Preview’-ing makes it easier to pick up these all too human errors. AlwaysPreview’ your article before publishing.
  • Endnote is a powerful and industry-standard tool. However, it is not fool-proof. Without the development of a robust reference template, references exported from a standard Endnote database will not be correctly formatted. You should always edit your Endnote reference output when publishing at The Nutrition Press and beyond.

For example, this line in WordPress’ main post editing box:

Screen Shot 2015-04-21 at 9.51.56 am

Will be automatically published with hyperlinks in-text as:

“It’s none of their business that you have to learn to write. Let them think you were born that way.”[1]

And automatically generate an ordered Reference Bibliography:

Reference

1.  ⇪   Hemingway E. Quotes on Writing. Neverland: Lost Boys Publishing; 1983. 43p

Images

  • Feature Image: All articles should have a ‘feature image’. A relevant attention grabbing image will attract the readership your hard-work deserves. When an original image is not possible, images should be primarily sourced from “Image Inject – Find Free Images”, an app that can be found at the bottom of your WordPress post editor screen. This will automatically find a generally high-quality image from the public-domain and insert a statement of copyright acknowledgement in your post.
  • Image Quality: Choose an image that is eye catching and is relevant to your article’s topic.
  • Image size (Kb): uploaded images should not exceed 150Kb or 800x600px. HD images sure are pretty, but they make life hard for readers on mobile devices or slow internet connections. In addition, TNP has a limited bandwidth with which to move data across the cloud. Uploading of unnecessarily large images consumes data-budget which could otherwise go to readership.
  • Image Format: Images should not be larger than 800x600px. Portable devices such as tablets or Notebooks are becoming the mainstay for web-browsing. In an age of short-attention-spans, scrolling past a poster-sized image on these platforms can quickly drain a viewer’s desire to read your hard-written work.

Publishing

  • Preview: It is recommended that you ‘Preview’ your article regularly as you write. ‘Preview’ is essential to seeing how the article will look when published.
  • Spell Check: Please perform a spell check before submitting your article.

Editing

The best editing process happens before an article is even written. The Editor’s job is to create a ‘theme’ across the website. This is best achieved when working as an Author-Editor team, developing Author ideas by providing counsel and advice on story-direction. There is an informal contract of privacy between each Author and Editor. This should be considered a safe space where opinions and ideas can be expressed freely. To preserve this, Authors may only see their own posts until publishing.

Publishing Checklist

  • ‘Featured-post’ checked.
  • Category selected.
  • Featured-image.
  • Spell check.
  • Preview format.
  • Correct/corrected Vancouver format.
  • In-text references have coded correctly.

FAQ / Help

I can’t change my status
Please contact one of the friendly senior-staff asap. 

Something has come up and I don’t think I can finish my article in time.
We respect that everyone has busy lives and that the unexpected happens. If you suspect a deadline can’t be met, please contact one of the senior-staff as-soon-as-possible. Don’t leave it until it’s too late.

I have used double square-brackets for my in-text references but they don’t output right in ‘Preview’.
Make sure that the style of the reference – including brackets – does not change within the reference. This can result in a minor HTML error. Try removing any formatting from the reference section, including brackets, using the ‘Clear Formatting’ button as indicated below.

Clear Formatting of Tricky References

 

When I Preview my paragraphs are spaced differently
A form of styling called CSS changes the look of internet-text dynamically. TNP has a set CSS-style that – among other things – automatically applies white-space between paragraphs.Generally, using normal styling and appropriate paragraphing lends to the automatically generated spacing. However, if you wish to create a new-line without creating space: try experimenting with ‘shift+enter’.

Last updated: 21 April, 2015