Difference between revisions of "ILRI blogging procedures"

From ilri-comms ilriwikis
(Imported from Wikispaces)
 
Line 1: Line 1:
−
=Publishing blog articles at ILRI=
+
All staff are responsible for writing blogs to raise awareness among ILRI audiences of the research undertaken by the institute and related outcomes of this work. These stories are posted on ILRI websites and social media channels are pushed out to users who sign up to receive this content. ILRI blog articles are widely disseminated via our several social media channels, including ILRI Twitter, LinkedIn and Facebook. Readers who find links to articles on regional, program and project blogs do not distinguish between these blogs and corporate materials. While the quality of blog articles will vary, an international standard of science reporting—with excellent English, clear messages, evidenced-based facts, unambiguous details and a coherent storyline—on all of ILRI's articles is absolutely necessary to protect the reputation of the institute.
  
−
All staff are responsible for writing blogs to raise awareness among ILRI audiences of the research undertaken by the institute and related outcomes of this work. These stories are posted on ILRI websites and social media channels are pushed out to users who sign up to receive this content.
 
  
−
=Ensuring the highest quality=
+
'''Responsibilities and approvals'''
−
 
 
−
ILRI blog articles are widely disseminated via our several social media channels, including ILRI Twitter, LinkedIn and Facebook. Readers who find links to articles on regional, program and project blogs do not distinguish between these blogs and corporate materials. While the quality of blog articles will vary, an international standard of science reporting—with excellent English, clear messages, evidenced-based facts, unambiguous details and a coherent storyline—on all of ILRI's articles is absolutely necessary to protect the reputation of the institute.
 
−
 
 
−
==Responsibilities and approvals==
 
 
# Blogs should be approved by program leaders, or the person delegated by him or her, before being submitted to CKM for a final check.
 
# Blogs should be approved by program leaders, or the person delegated by him or her, before being submitted to CKM for a final check.
 
# Any sensitive material which could potentially damage the reputation of ILRI or cause offence to its partners should be sent the relevant deputy director general for research or biosciences for approval.
 
# Any sensitive material which could potentially damage the reputation of ILRI or cause offence to its partners should be sent the relevant deputy director general for research or biosciences for approval.
−
# Responsibility for the scientific quality of blog articles lies with the respective ILRI program leaders and their directors of research—not with the communications staff posting the blog or with the ILRI CKM unit.
+
# Responsibility for the scientific quality of blog articles lies with the respective ILRI program leaders and their directors of research—not with the communications staff posting the blog or CKM.
  
−
==Steps==
+
We use blogs hosted on WordPress to publish stories about ILRI and the work being done across ILRI (and beyond). Our blogs should contain:
−
# Approved texts should be submitted to the relevant embedded communications officer for the program/project who will undertake review of the text.
 
−
# For those programs or projects without an embedded communications officer, texts should be sent directly to CKM Senior Communications Officer, Paul Karaimu, or to Susan MacMillan in the case of the ILRI News and Clippings blogs.
 
−
# Paul undertakes light editing, proofreading and ensures the text is in line with the [https://cgspace.cgiar.org/handle/10568/33429| ILRI style guide]. (ILRI CKM and embedded communications staff are responsible for ensuring ILRI articles adhere to the style guide).
 
−
# Paul is not, however, responsible for the quality of the content and will send back to the original blog drafters, and their program leaders, any work that he finds confusing or otherwise substandard.
 
−
# The recommended corrections and approvals should then be incorporated and sent back to Paul Karaimu for publication. In the event that a series of substandard articles is submitted to him from a communications or scientist blogger, Paul will alert the head of publishing, James Stapleton, for appropriate action and the relevant program leader.
 
−
# Once approved by CKM, you or your embedded communications officer should upload it to the website. For each blog article, tick all relevant categories and insert key words as tags ([[ilri tagging guidelines| see ilri tagging guidelines here]]). The relevant presentations, pictures, etc. should be embedded (using the embed functionalities from Slideshare, Flickr etc.). Do not upload ILRI photos directly on the blog (by posting them to [https://www.flickr.com/photos/ilri/| ILRI Flickr] or elsewhere they become available for wider use). See more about this below ('Pictures and videos').
 
−
 
 
−
=Our blogs=
 
−
We use blogs hosted on WordPress to publish stories about ILRI and the work being done across ILRI (and beyond). See [[ilriblogs| list of ILRI blogs]].
 
−
 
 
−
Our blogs should contain:
 
 
* original stories
 
* original stories
−
* interviews or profiles of people (or projects)
+
* interviews or profiles of people or projects
 
* updates on projects, people, products, events
 
* updates on projects, people, products, events
−
* opinion pieces by ilri-associated people
+
* opinion pieces by ILRI-associated people
−
 
+
'''General blogging guidelines'''
−
When blogging, please follow these steps:
+
# Follow [https://hdl.handle.net/10568/33429 ILRI's style guide].
−
 
+
# Read the posts on ILRI's two main corporate blogs—News and Clippings—to get a sense of ILRI's blog style.
−
===Writing===
+
# Write simply and clearly to interest, engage and be understood by non-ILRI, non-scientific and non-livestock oriented audiences, many of whom have another first language.
−
# <span style="line-height: 1.5;">Follow [https://cgspace.cgiar.org/handle/10568/33429| ILRI's style guide].</span>
+
# Use words and language most 14-year-olds would understand.
−
# <span style="color: #000000; line-height: 1.5;">Read the posts on ILRI's two main corporate blogs—News and Clippings—to get a sense of ILRI's blog style.</span>
+
# Use active (not passive) verbs: 'The dog bit the man' (not 'the man was bitten by the dog').
−
# <span style="line-height: 1.5;">Write simply and clearly to interest, engage and be understood by non-ILRI, non-scientific and non-livestock oriented audiences, many of whom have another first language.</span>
+
# Avoid jargon and specialist vocabulary ('participatory research').
−
# <span style="line-height: 1.5;">Use words and language most 14-year-olds would understand.</span>
+
# Avoid cliches ('a picture is worth a thousand words') unless you use them knowingly (with wit, etc.).
−
# <span style="line-height: 1.5;">Use active (not passive) verbs: 'The dog bit the man' (not 'the man was bitten by the dog').</span>
+
# Avoid acronyms; if absolutely necessary to use an acronym, always spell it out in full on first use.
−
# <span style="line-height: 1.5;">Avoid jargon and specialist vocabulary ('participatory research').</span>
+
# Always spell out 'ILRI' in full on first use.
−
# <span style="line-height: 1.5;">Avoid cliches ('a picture is worth a thousand words') unless you use them knowingly (with wit, etc.).</span>
+
# Tell a story wherever possible.
−
# <span style="line-height: 1.5;">Avoid acronyms; if absolutely necessary to use an acronym, always spell it out in full on first use.</span>
+
# Or: find an interesting angle/approach: look back at an old issue from a new lens, debate between perspectives, interview someone knowledgeable, interview someone with a candid view, write in a cross-cutting/lateral way (using curated content), make predictions for the future, seek stories about peoples' epiphanies, make a commentary on an otherwise rather 'dry' publication or output...
−
# <span style="line-height: 1.5;">Always spell out 'ILRI' in full on first use.</span>
+
# If making a statement that is your opinion but not evidence-based, make that clear.
−
# <span style="line-height: 1.5;">Tell a story wherever possible.</span>
 
−
# <span style="line-height: 1.5;">Or: find an interesting angle/approach: look back at an old issue from a new lens, debate between perspectives, interview someone knowledgeable, interview someone with a candid view, write in a cross-cutting/lateral way (using curated content), make predictions for the future, seek stories about peoples' epiphanies, make a commentary on an otherwise rather 'dry' publication or output...</span>
 
−
# <span style="line-height: 1.5;">If making a statement that is your opinion but not evidence-based, make that clear.</span>
 
 
# Provide depth and background—most blog articles will be at least 400-500 words long.
 
# Provide depth and background—most blog articles will be at least 400-500 words long.
 
# Double check all the facts in the story. Accuracy is of the utmost importance to the reputation of ILRI.
 
# Double check all the facts in the story. Accuracy is of the utmost importance to the reputation of ILRI.
 
# Make sure the story line and the messages you wish to highlight come through.
 
# Make sure the story line and the messages you wish to highlight come through.
 
# Carefully proofread your article before submitting it for approval to ensure it has no spelling or grammatical errors, no typos or missing words, and is complete.
 
# Carefully proofread your article before submitting it for approval to ensure it has no spelling or grammatical errors, no typos or missing words, and is complete.
−
# <span style="line-height: 1.5;">Once your blog post has been published, promote it on relevant personal and institutional social media and conversation spaces (all ILRI blog posts are automatically disseminated across ILRI social media channels and ILRI website/ilrinet/yammer).</span>
+
# Once your blog post has been published, promote it on relevant personal and institutional social media and conversation spaces. All ILRI blog posts are automatically disseminated across ILRI social media channels and on the ILRI website.
−
# <span style="line-height: 1.5;">Liven up your article with quotes from staff and partners and others; format the quotes as 'display quotes' to break up the text.</span>
+
# Liven up your article with quotes from staff and partners and others; format the quotes as 'display quotes' to break up the text.
−
# <span style="line-height: 1.5;">Write regularly so that your readers have something new to read at least weekly.</span>
+
# Write regularly so that your readers have something new to read at least weekly.
 +
 
 +
'''Headlines'''
 +
 
 +
Pay particular attention to your headline (think about what will be short and interesting enough for Twitter), try and provide context in the title (e.g. 'AfricaRISING West Africa review and planning meeting creates surprise about partnership agreements' not 'Bamako meeting creates surprise'), picture caption, introductory sentence and paragraph and closing paragraph. Remember, your headlines 'have a life of their own' on the internet. They often/usually appear out of context. Most users will come across them NOT on your blog or website.
 +
 
 +
'''Excerpts'''
  
−
===Headlines===
+
In Wordpress, create an 'excerpt' for each story; this is normally the first paragraph introducing the blog post. The Wordpress excerpt is taken into the feed and online posts and avoids, for instance, the photo caption becoming the text that is posted automatically.
−
<span style="line-height: 1.5;">Pay particular attention to your headline (think about what will be short and interesting enough for Twitter), try and provide context in the title (e.g. 'Africa RISING West Africa review and planning meeting creates surprise about partnership agreements' not 'Bamako meeting creates surprise'), picture caption, introductory sentence and paragraph and closing paragraph. Remember, your headlines 'have a life of their own' on the internet. They often/usually appear out of context. Most users will come across them NOT on your blog or website.</span>
 
  
−
===Excerpts===
+
'''Categories and tags'''
−
In wordpress, create an 'excerpt' for each story - this is normally the first paragraph introducing the blog post. In wordpress, this excerpt text is taken into the feed, online posts etc. and it avoids for instance the photo caption becoming the text that is posted/shared automatically.
 
  
−
==='''Categories and tags'''===
+
ILRI is a front-runner in tagging and categorizing its published work so that that work can be easily found, re-purposed and re-published. This demands discipline by ILRI bloggers in ensuring that each article posted is appropriately tagged. For each blog article, tick all relevant categories and insert key words as tags (refer to tagging guidelines). The choice of categories is very important as this forms the basis for aggregation on ILRI website and elsewhere.
−
ILRI is a front-runner in tagging and categorizing its published work so that that work can be easily found, re-purposed and re-published. This demands discipline by ILRI bloggers in ensuring that each article posted is appropriately tagged. For each blog article, tick all relevant categories and insert key words as tags ([[ilri tagging guidelines| see ilri tagging guidelines here]]). The choice of categories is very important as this forms the basis for aggregation on ILRI website and elsewhere. If you have any questions, please contact Abenet Yabowork.
 
  
−
===<span style="line-height: 1.5;">Photos and videos</span>===
+
'''Photos and videos'''
−
# <span style="line-height: 1.5;">Enhance your article with an interesting (and sharp) image; search among ILRI's Flickr 'galleries' (and give credit to other photographers) as well as 'sets'.</span>
+
# Enhance your article with an interesting (and sharp) image; search among ILRI's Flickr 'galleries' (and give credit to other photographers) as well as 'sets'.
−
# <span style="line-height: 1.5;">Don't use the same photo again and again on the same blog.</span>
+
# Don't use the same photo again and again on the same blog.
−
# <span style="line-height: 1.5;">Make a blog post for each audio/video interview made.</span>
+
# Make a blog post for each audio/video interview made.
−
# <span style="line-height: 1.5;">Do not upload a file or ILRI images into a blog. Documents should be on CGSpace or the internet; ILRI images on Flickr; videos on youtube.</span>
+
# Do not upload a file or ILRI images into a blog. Documents should be on CGSpace or the internet; ILRI images on Flickr; videos on YouTube.
  
−
===<span style="line-height: 1.5;">'''Links'''</span>===
+
'''Links'''
−
<span style="line-height: 1.5;">Your blog post should never be a 'dead end.' It should send visitors to other interesting/related resources and links. Always set the link to 'open in a new page'.</span>
 
  
−
='''<span style="font-size: 1.1em;">[[blogging resources| Resources on blogging]]</span>'''.=
+
Your blog post should never be a 'dead end.' It should send visitors to other interesting/related resources and links. Always set the link to 'open in a new page'.

Revision as of 04:53, 9 January 2019

All staff are responsible for writing blogs to raise awareness among ILRI audiences of the research undertaken by the institute and related outcomes of this work. These stories are posted on ILRI websites and social media channels are pushed out to users who sign up to receive this content. ILRI blog articles are widely disseminated via our several social media channels, including ILRI Twitter, LinkedIn and Facebook. Readers who find links to articles on regional, program and project blogs do not distinguish between these blogs and corporate materials. While the quality of blog articles will vary, an international standard of science reporting—with excellent English, clear messages, evidenced-based facts, unambiguous details and a coherent storyline—on all of ILRI's articles is absolutely necessary to protect the reputation of the institute.


Responsibilities and approvals

  1. Blogs should be approved by program leaders, or the person delegated by him or her, before being submitted to CKM for a final check.
  2. Any sensitive material which could potentially damage the reputation of ILRI or cause offence to its partners should be sent the relevant deputy director general for research or biosciences for approval.
  3. Responsibility for the scientific quality of blog articles lies with the respective ILRI program leaders and their directors of research—not with the communications staff posting the blog or CKM.

We use blogs hosted on WordPress to publish stories about ILRI and the work being done across ILRI (and beyond). Our blogs should contain:

  • original stories
  • interviews or profiles of people or projects
  • updates on projects, people, products, events
  • opinion pieces by ILRI-associated people

General blogging guidelines

  1. Follow ILRI's style guide.
  2. Read the posts on ILRI's two main corporate blogs—News and Clippings—to get a sense of ILRI's blog style.
  3. Write simply and clearly to interest, engage and be understood by non-ILRI, non-scientific and non-livestock oriented audiences, many of whom have another first language.
  4. Use words and language most 14-year-olds would understand.
  5. Use active (not passive) verbs: 'The dog bit the man' (not 'the man was bitten by the dog').
  6. Avoid jargon and specialist vocabulary ('participatory research').
  7. Avoid cliches ('a picture is worth a thousand words') unless you use them knowingly (with wit, etc.).
  8. Avoid acronyms; if absolutely necessary to use an acronym, always spell it out in full on first use.
  9. Always spell out 'ILRI' in full on first use.
  10. Tell a story wherever possible.
  11. Or: find an interesting angle/approach: look back at an old issue from a new lens, debate between perspectives, interview someone knowledgeable, interview someone with a candid view, write in a cross-cutting/lateral way (using curated content), make predictions for the future, seek stories about peoples' epiphanies, make a commentary on an otherwise rather 'dry' publication or output...
  12. If making a statement that is your opinion but not evidence-based, make that clear.
  13. Provide depth and background—most blog articles will be at least 400-500 words long.
  14. Double check all the facts in the story. Accuracy is of the utmost importance to the reputation of ILRI.
  15. Make sure the story line and the messages you wish to highlight come through.
  16. Carefully proofread your article before submitting it for approval to ensure it has no spelling or grammatical errors, no typos or missing words, and is complete.
  17. Once your blog post has been published, promote it on relevant personal and institutional social media and conversation spaces. All ILRI blog posts are automatically disseminated across ILRI social media channels and on the ILRI website.
  18. Liven up your article with quotes from staff and partners and others; format the quotes as 'display quotes' to break up the text.
  19. Write regularly so that your readers have something new to read at least weekly.

Headlines

Pay particular attention to your headline (think about what will be short and interesting enough for Twitter), try and provide context in the title (e.g. 'AfricaRISING West Africa review and planning meeting creates surprise about partnership agreements' not 'Bamako meeting creates surprise'), picture caption, introductory sentence and paragraph and closing paragraph. Remember, your headlines 'have a life of their own' on the internet. They often/usually appear out of context. Most users will come across them NOT on your blog or website.

Excerpts

In Wordpress, create an 'excerpt' for each story; this is normally the first paragraph introducing the blog post. The Wordpress excerpt is taken into the feed and online posts and avoids, for instance, the photo caption becoming the text that is posted automatically.

Categories and tags

ILRI is a front-runner in tagging and categorizing its published work so that that work can be easily found, re-purposed and re-published. This demands discipline by ILRI bloggers in ensuring that each article posted is appropriately tagged. For each blog article, tick all relevant categories and insert key words as tags (refer to tagging guidelines). The choice of categories is very important as this forms the basis for aggregation on ILRI website and elsewhere.

Photos and videos

  1. Enhance your article with an interesting (and sharp) image; search among ILRI's Flickr 'galleries' (and give credit to other photographers) as well as 'sets'.
  2. Don't use the same photo again and again on the same blog.
  3. Make a blog post for each audio/video interview made.
  4. Do not upload a file or ILRI images into a blog. Documents should be on CGSpace or the internet; ILRI images on Flickr; videos on YouTube.

Links

Your blog post should never be a 'dead end.' It should send visitors to other interesting/related resources and links. Always set the link to 'open in a new page'.

Retrieved from "http://ilri-comms.ilriwikis.org/index.php?title=ILRI_blogging_procedures&oldid=451"