Difference between revisions of "Blog Writing Process"

From edegan.com
Jump to navigation Jump to search
Line 5: Line 5:
 
==Step by Step==
 
==Step by Step==
  
Please follow the following steps:
+
Please follow the following steps (set your content status as your enter each stage):
#Before beginning a blog post, blog writers must get preliminary approval from Anne or Ed. To propose a blog post, sketch the idea in 2-3 sentences in a post on the #bloggers Slack Channel. Include links to at least three sources you would draw on to write the post. State the implications for public policy on entrepreneurship, innovation, or public policy in your proposal.
+
#'''Idea''': Before beginning a blog post, blog writers must get preliminary approval from Anne or Ed. To propose a blog post, sketch the idea in 2-3 sentences in a post on the #bloggers Slack Channel. Include links to at least three sources you would draw on to write the post. State the implications for public policy on entrepreneurship, innovation, or public policy in your proposal.
#Once your idea is approved, set up a wiki page for the blog post. Include (Blog Post) in the title and make the wiki page using [[Form:BlogPost]]. Follow the technical instructions in the section below carefully. Include the proposal, all sources, an editable link to the google doc, and any other relevant information.
+
#'''Draft''': Once your idea is approved, set up a wiki page for the blog post. Include (Blog Post) in the title and make the wiki page using [[Form:BlogPost]]. Follow the technical instructions in the section below carefully. Include the proposal, all sources, an editable link to the google doc, and any other relevant information.
# Drafts are due one week after your idea is approved. Once the draft is ready for review, tell Anne. She will assign you a peer editor. He or she will make suggestions and return the blog post to the writer. The writer will revise the draft based on these suggestions
+
#'''Peer edit''': Drafts are due one week after your idea is approved. Once the draft is ready for review, tell Anne. She will assign you a peer editor. He or she will make suggestions and return the blog post to the writer. The writer will revise the draft based on these suggestions
#Give the revised draft to Anne, completing the same process of suggestion and revision as with the peer editor in Step 1. If any large changes are made in this process, the writer will give the new draft to another available peer editor to check for grammar/content one last time before giving it to Ed. This process may have to be repeated more than once if the blog needs further development.
+
#'''Revision''': Give the revised draft to Anne, completing the same process of suggestion and revision as with the peer editor in Step 1. If any large changes are made in this process, the writer will give the new draft to another available peer editor to check for grammar/content one last time before giving it to Ed. This process may have to be repeated more than once if the blog needs further development. Give the final draft Anne for approval.
#Give the final draft Anne for approval. Once Anne’s approval is given, the piece can be posted in the blog using Steps 5-6. See [[Working with Wordpress]] for detailed instructions.  
+
#'''In Wordpress''': Once Anne’s approval is given, the piece can be posted in the blog using Steps 5-6. See [[Working with Wordpress]] for detailed instructions.  
 
#'''Simultaneously with Steps 1-3:''' Select two or more graphics for the blog post (one as featured image, one for within the post itself), making sure that we are authorized to use the image and that we have the proper citations. Write a caption for the graphic. Give all of this to the Graphics Editor for approval.
 
#'''Simultaneously with Steps 1-3:''' Select two or more graphics for the blog post (one as featured image, one for within the post itself), making sure that we are authorized to use the image and that we have the proper citations. Write a caption for the graphic. Give all of this to the Graphics Editor for approval.
 
#Once the graphics and content have been approved, the writer can post it all into WordPress. The writer needs to make the page visually appealing and set up the WordPress features- Use our [[Working with WordPress]] page for help (SEO, Readability, Tags, Hyperlinks). At this point, the blog post will be ready for publication, but should be labeled as a Visibility: "Private" within WordPress (not public yet).
 
#Once the graphics and content have been approved, the writer can post it all into WordPress. The writer needs to make the page visually appealing and set up the WordPress features- Use our [[Working with WordPress]] page for help (SEO, Readability, Tags, Hyperlinks). At this point, the blog post will be ready for publication, but should be labeled as a Visibility: "Private" within WordPress (not public yet).
#Notify the Online Editor (see our [[Blog Team]] page for details) that the post is completely ready to be published. The Online Editor checks that the post is at the quality we expect for publishing, looking at graphics, plugins, content, title, etc. The Online Editor can then publish it to the public in WordPress.
+
#Notify the Online Editor (see our [[Blog Team]] page for details) that the post is completely ready to be published. The Online Editor checks that the post is at the quality we expect for publishing, looking at graphics, plugins, content, title, etc. The Online Editor can then publish it to the public in WordPress and set the status to '''Published'''.
  
 
===Due Dates and Expectations===
 
===Due Dates and Expectations===

Revision as of 15:54, 31 October 2016

This page is useful to those Writing Blog Posts at the McNair Center.

We have a step-by-step Blog Writing Process that we expect McNair Staff to follow. Amendments to the process should be done only in consultation with the Blog Team. This process ensures that everyone creates a page for their blog post using Form:BlogPost so that everything we do can be tracked and stored, and so that we can all work together efficiently. Please see the detailed instructions for creating a wiki page for your blog post.

Step by Step

Please follow the following steps (set your content status as your enter each stage):

  1. Idea: Before beginning a blog post, blog writers must get preliminary approval from Anne or Ed. To propose a blog post, sketch the idea in 2-3 sentences in a post on the #bloggers Slack Channel. Include links to at least three sources you would draw on to write the post. State the implications for public policy on entrepreneurship, innovation, or public policy in your proposal.
  2. Draft: Once your idea is approved, set up a wiki page for the blog post. Include (Blog Post) in the title and make the wiki page using Form:BlogPost. Follow the technical instructions in the section below carefully. Include the proposal, all sources, an editable link to the google doc, and any other relevant information.
  3. Peer edit: Drafts are due one week after your idea is approved. Once the draft is ready for review, tell Anne. She will assign you a peer editor. He or she will make suggestions and return the blog post to the writer. The writer will revise the draft based on these suggestions
  4. Revision: Give the revised draft to Anne, completing the same process of suggestion and revision as with the peer editor in Step 1. If any large changes are made in this process, the writer will give the new draft to another available peer editor to check for grammar/content one last time before giving it to Ed. This process may have to be repeated more than once if the blog needs further development. Give the final draft Anne for approval.
  5. In Wordpress: Once Anne’s approval is given, the piece can be posted in the blog using Steps 5-6. See Working with Wordpress for detailed instructions.
  6. Simultaneously with Steps 1-3: Select two or more graphics for the blog post (one as featured image, one for within the post itself), making sure that we are authorized to use the image and that we have the proper citations. Write a caption for the graphic. Give all of this to the Graphics Editor for approval.
  7. Once the graphics and content have been approved, the writer can post it all into WordPress. The writer needs to make the page visually appealing and set up the WordPress features- Use our Working with WordPress page for help (SEO, Readability, Tags, Hyperlinks). At this point, the blog post will be ready for publication, but should be labeled as a Visibility: "Private" within WordPress (not public yet).
  8. Notify the Online Editor (see our Blog Team page for details) that the post is completely ready to be published. The Online Editor checks that the post is at the quality we expect for publishing, looking at graphics, plugins, content, title, etc. The Online Editor can then publish it to the public in WordPress and set the status to Published.

Due Dates and Expectations

A draft of a post will be expected for peer editing no later than one week after the idea is approved. Peer editors must complete their editing within one shift of being assigned to a post. Then the post should go to Anne. After Anne’s edits are received, a new draft is expected one shift later. Tighter timelines may be specified depending on circumstances.

Assorted Things to Remember

  • Be sure to link your blog post to your personal page
  • Before you officially draft your post, put your notes, ideas, thoughts, and data you have gathered onto your wiki page
  • Images for your post: all images must be creative commons licensed. Include the caption and any attribution for the photos and other illustrations in the caption area of the media file
  • Note: please make sure you present a balanced view (nothing which heavily leans to one side of the political aisle or the other). The McNair Center is a part of the Baker Institute, which is a non-partisan think tank.

Creating a wiki page for your blog post

Use this page in conjunction with the Form:BlogPost to create your blog post's wiki page. This is mandatory. Using the form will create a template and make sure that your r blog post is tracked on the Writing Blog Posts page, as well as the All McNair blog posts page.

Structuring your Wiki Page

Create your wiki page using Form:BlogPost:

  • Title - Give your post a punchy title. Use this title followed by " (Blog Post)" as the name of your wiki page and enter exactly the same title, complete with " (Blog Post)", into the box on Form:BlogPost.
  • Fill out other fields in the form carefully:
    • Author - Your name is it appears on your wiki page
    • Series - As applicable. Reuse existing series names when possible.
    • Content status - set to idea to start with and adjust accordingly.
    • Graphic status - set to none to start with and adjust accordingly.
    • Blog image - only include this when your graphics have been approved.
    • Publication date - leave blank until your post is published.

Then in the main (free text) section input the following:

  • Abstract: 2-3 sentences
  • Link to Google Doc
  • Link to published blog post (as applicable)
  • List of references with links

Editing your blog post page

When you need to edit your blog post's wiki page, you should generally edit it using "Edit with Form" to make sure your data stays consistent.

Check your page shows up in the search results

Check you page shows up by going to All McNair blog posts. If you can't see it there, do a NULL EDIT (i.e., edit and save the page without doing anything), and check again.

Converting an existing wiki page to a blog post page

If you have a pre-existing wiki page that you need to convert to a blog post page you need to do the following:

Remove an category tags, etc

Remove any category assignments. They look like [[category:some category]]<nowiki>. Links to categories, which do not assign a page to a category, can stay. Category link tags look like <nowiki>[[:category: some category]].

Also remove any old code that is no longer needed. Examples include:

 <includeonly>...</includeonly>
 <!-- flush -->
 

Add and complete the blog post template

Add a copy of Template:BlogPost manually to the top of your page. The resulting code should look like:

 {{BlogPost
 |Title=
 |Author=
 |Series=
 |Content status=
 |Graphics status=
 |Blog image=
 |Publication date=
 }} 
  

...but with each of the values filled out, as described in the section above.