Sunday, June 23, 2013

How to write effective blog posts | ffeathers

Our technical writing team at Atlassian has just started presenting a series of workshops for other Atlassians, on how to write effectively. This post contains the material for a workshop that focuses on writing blog posts. I?d love any feedback you may have.

In an earlier post about the workshops, I wrote how enjoyable and rewarding it is for us, as technical writers, to present these workshops. That post also contains the material for the first workshop, which focuses on writing effective ?how to? guides, and describes the format of the workshops.

Now let?s take a look at the workshop material on effective blogging.

Getting started on your blog post

How do you write a blog post?
One word at a time? not!

The big picture is the important thing.

  • Sit back, think, and plan the post before you start.
  • While writing, if the words don?t come, make a note and continue writing. Preserve the big picture. Come back later to fill in the gaps.

A philosophy of blogging

Choose your style, then grab your reader:

  • Maintain a character in your blog, so that people can start seeing you as a friend. Be yourself. (More about the social side later on.)
  • Consider your tone. If you?re writing on a corporate blog, read the guidelines on corporate voice, tone and style.
  • Write each post around a story or a ?hook?. This will give the post a theme, making it easier for you to write and easier for people to read. (More about telling a story later on.)
  • Add structure to the content. Add headings. Split the information into easily-readable chunks. People want to skim and dip in. (More about structure later on.)
  • Tap into the power of social media. Link to other blogs and respond to comments. (More about the social side later on.)
  • Take advantage of your creative subconscious. Make notes, wherever you are. Writing is a creative process, and it keeps happening even when you think you?ve stopped! You?ll find yourself thinking of stuff to add to your document at odd times. While walking in the bush. Or in the middle of the night. Make a note. Email yourself. Put it?on Remember The Milk. Whatever works. Such ideas are gems, and they?re at their freshest when you first think of them. Grab that freshness.

View every experience as fodder for your blog

Whenever something happens, think to yourself: ?How does this fit into my blog??

You can even write multiple blog posts as a result of a single experience or event. A while ago I wrote 4 posts resulting from one Atlassian ShipIt day (then called ?FedEx days?), each post with a different theme:

  • A blog post on ffeathers, for people who are not Atlassians. This post introduces the concept of ShipIt (then called FedEx Day), tells the story of technical writers taking part in what is essentially a developer-focused activity, and shows lots of pictures.
  • An Atlassian ShipIt delivery note, describing the purpose and results of my ShipIt project. This is a more formal post. Everyone who takes part in ShipItis supposed to write one of these.
  • Another post on ffeathers, describing the software that I evaluated as part of the ShipIt project. This software, the SHO tool for guided help, is of interest to technical writers so it was useful to write it up separately.
  • A post on the Atlassian company blog, describing the new SDK (software development kit) that I used. This post is aimed at developers, showing them that the SDK makes it easy for even a technical writer to develop an add-on. There?s a fair bit of technical detail in the article. It?s also promotional, as suited to a company blog.

I could write another post about how to write 5 blog posts from one experience. (wink)

How to go about writing a blog post

[A useful practical guide.]

Step by step:

  1. Decide on your audience.
  2. Write the introduction.
  3. Write the title.
  4. Outline the post by creating the headings.
  5. Fill in the details. Keep each section short.
  6. If unsure, or struggling to find the right words, make a ?TO DO? note and continue. Come back later.
    Hint: I use ?xxxxxxxxxxxxxx? instead of ?TO DO?. It?s quick to type, strangely satisfying, easy to search for, and stands out when I?m reviewing the page.
    [This bit often leads to some animated discussion amongst workshop participants. Some of them already do something similar. Others love the idea, and smile with delight.]
  7. Review the content yourself:
    • Have you included everything you intended to include?
    • Can you cut anything out?
    • Should you split the post into two?
    • Is your language and tone right for the audience?
  8. Ask someone else to review the page.
    As any writer will tell you, it?s impossible to review your own work. Your brain knows what you wanted to say, and that?s what your brain will see even if that?s not what?s written.

Talking to your audience

User icon: rrobinsUser icon: keganUser icon: jmlemieuxUser icon: brollins

Who do you want to read the post? Who are the people you?re writing for, and what do they already know?

  • Think about those people carefully. Make a mental picture of a person who has the characteristics of your target audience.
  • Use that imagined person to make all decisions about your post.
  • When in doubt about wording, speak to the imagined person out loud. Then write down what you said. Immediately.
  • If there?s more than one audience, consider writing a separate post for each audience. You could consider publishing the posts on different blogs.

Writing the introduction

Start the story right at the top. Tell people what the post is about and why you?re writing it. Hook the readers by letting them know you?re going to tell them a story.

Examples of a good introduction:

[At this point, the presenter opens each of the examples and talks the attendees through the salient points. We use the same articles to illustrate other points in the workshop later on.]

  • 5 Things I Learned When I Moved My Business to an Island
    ?There are small towns. There are rural areas. And then there are islands. Islands that have no bridges, only ferries.
    Ferries that blow their horns on foggy days. That break down at the worst possible moment, usually when you have an important meeting with a new client. Ferries that will take you back home if you show up in line before the last one leaves the dock, at 7:30pm sharp?.?
  • Social Media Fail: 5 Reasons I Will Unfollow You
    ?The other day, I unfollowed someone on Twitter. At first glance, we appeared to have lots in common??

Concocting a title

Make sure the title reflects the main story. This will attract readers and give you a good position in search results such as Google or Bing.

The title is your most important tool for helping people find your document. This is especially true on EAC, where people use the quick search a lot.

  • Put the key information at the beginning of the title.
  • Make the title describe the purpose of the document.
  • Be clever if you can

Example of a great title: Stash 2.4: Forking in the Enterprise

Telling a story

Write each post around a story or a ?hook?. This will give the post a theme, making it easier for you to write and easier for people to read.

What is a story?

  • The simplest type of story is a use case.
  • Another good story is something that went wrong, and how you fixed it.
  • Or you could tell a funny story, provided it relates to the main content of the post.

Moving on to the main part of the post:

  • Describe your part in the story. Make it about you, or your team.
  • Then move quickly to the main topic.
  • Give plenty of factual information, preferably hard-won. That?s what people value. Code samples and screenshots are great.
  • Tell how the events changed you, changed the way you work, changed your product. That?s what a story is all about.

Examples of good story-telling:

Structuring a post

Add structure to the content. Yes, even in a blog post. People will skim and dip in. If they can?t do that, they?ll leave.

  • Split the content into easily-digestible chunks. Keep them short.
  • Use plenty of headings, so people can find the chunk they need. Research shows people?s eyes jump from heading to heading as they skim a page.

Example of good structure: 5 Things I Learned When I Moved My Business to an Island ? notice the highlighted bullet points and easily-digestible sections.

Language and style

Keep it short and simple

Use simple words and short sentences.

Use active voice rather than passive

[Explain the difference between active and passive. Hold a bit of a discussion here. This is a difficult concept for many people.]

Examples:

  • Passive: The chocolate was eaten by the technical writer.
  • Active: The technical writer ate the chocolate.

Why use active voice? It?s shorter. And passive voice can be confusing, because sometimes it doesn?t say who must do what. Imperative (command) is even better, when appropriate.

Bad:

Your browser must be configured to xxx.
Reader thinks: OK, so I?ll assume someone has already done that for me when setting up my machine.

Good:

Configure your browser to xxx.
Reader thinks: OK, I?ll do that now.

Clarify technical terms and abbreviations

Explain important concepts at the top of the page.

Spell out each abbreviation the first time you use it on a page. For example:

If you?re using IE (Internet Explorer), ?.

How to make sure people find your post

Let?s look at SEO (search engine optimisation). These are the key points for making sure people find your post:

  • Make the title meaningful, with important words near the beginning.
  • Make sure the URL contains real words.
    If you are blogging on Confluence, don?t use special characters like ??? in a page title, because the resulting URL will not contain words.
  • Decide the key words for your post. These are the key concepts, and the ones the people are likely to look for when searching.
  • Put your key words at the top of the post, in the introductory paragraph.
    This ties in well with our structure, where the first section contains a introduction and a summary of the story.
  • Put your key words in the headings in your post.

Making use of ?social?

Blogging is a social activity. Tap into the power of social media:

  • Maintain a character in your blog, so that people can start seeing you as a friend.
  • Be yourself. Otherwise it?s difficult to maintain a consistent persona and people will soon pick it up if you don?t sound real.
  • Link to other people?s blogs. If your idea is an expansion of something someone else has written, include a mention of where you got the idea. If you?ve seen someone?s post about a related topic, link to it. The other bloggers appreciate this and will start linking back to you in return.
  • Be nice, positive and sincere. If you disagree with something, say so but be constructive. Some bloggers are successful by being horrid, but to make that work you have to be really good and have a curl on your forehead. I don?t like nastiness, manipulation or one-upmanship, so I wouldn?t recommend it.
  • Watch the post, and respond to comments. Build your audience, by showing them you care.
  • Find other blogs on a related topic, add comments there, and where relevant link back to your own post.

Resources

  • Kurt Vonnegut?s How to Write With Style.

    A great thing about Kurt?s guide is that it illustrates his principles so perfectly. This excerpt is from the section called ?Sound like yourself?:

    ?lucky indeed is the writer who has grown up in Ireland, for the English spoken there is so amusing and musical. I myself grew up in Indianapolis, where common speech sounds like a band saw cutting galvanized tin, and employs a vocabulary as unornamental as a monkey wrench.

    This bit is pretty cool too:

    Pity the readers

  • [Link to your corporate stylesheets and guidelines here too.]
  • Bloggers? tips on blogging:
    • Seth?s post way back in 2006, a bit sparse on the ?how to? but eminently elegant as always: How to write a blog post.
    • Seth?s post with more down-to-earth tips: Write like a blogger.
    • Neil Patel?s tips on engaging your readers in your blog: How to Write a Blog Post. Start reading from the top, then see what he has to say in the section titled ?Hook your Readers?. It?s awesome.
    • My own, more personal account of blogging, from which some of the above material is drawn: How to write a blog post.

Like this:

Like Loading...

Source: http://ffeathers.wordpress.com/2013/06/23/how-to-write-effective-blog-posts/

Ohio Lottery Colorado Lottery Pa Lottery Ebates lotto Illinois Lottery texas lottery

10 Amazon Packaging Disasters That Defy Explanation

10 Amazon Packaging Disasters That Defy Explanation

Shopping on Amazon is so convenient, it's gotten to the point that I use it to buy obscenely mundane things just to avoid crossing the street. "Ugh, I need a roll of electrical tape." Click. Done. The dark side of this super-efficient e-commerce empire? Sometimes, the gear is shipped in boxes that don't exactly make sense for the merchandise inside of them.

Depending on who you ask, these mishaps occur for a number of reasons?either because of computer errors, because the packaging center ran out of a smaller boxes, or because bigger boxes are less likely to get lost. Either way, the ensuing packaging hijinks are hilarious?check out ten of the best below.

Wusthof makes lovely knife products. But this knife steel isn't even sharp?so was it really necessary to send it in this box?

10 Amazon Packaging Disasters That Defy Explanation


Here's another knife-related snafu.

10 Amazon Packaging Disasters That Defy Explanation

Image via Reddit user Slippy13.


This box, containing shaving tools, could use a shave itself.

10 Amazon Packaging Disasters That Defy Explanation


This person made the discerning decision to purchase the Beatles box set mixed in mono instead of stereo. Someone (or something) made the wrong decision about what box to ship it in.

10 Amazon Packaging Disasters That Defy Explanation


I'm not even sure what this is. But really?

10 Amazon Packaging Disasters That Defy Explanation


This could've easily fit into an envelope.

10 Amazon Packaging Disasters That Defy Explanation


The packaging probably weighed more than the product, in this case.

10 Amazon Packaging Disasters That Defy Explanation


But, you know, the more I look at these boxes containing incredibly easily-procured items that I want to order overnight...

10 Amazon Packaging Disasters That Defy Explanation


...the more I wonder if it's me that's being lazy.

10 Amazon Packaging Disasters That Defy Explanation


Though, really, does a battery this small need all of this?

10 Amazon Packaging Disasters That Defy Explanation

Image via Reddit.

Source: http://gizmodo.com/10-amazon-packaging-disasters-that-defy-explanation-5994685

born free walking dead finale nascar bristol narwhal st louis university mario manningham mario manningham

Saturday, June 22, 2013

Windows 8 Music update brings in-app searching, login-free trial streaming

Music on Windows 8 update brings in-app searching, login-free trial listening

Believe it or not, the Music app in Windows 8 hasn't let users easily search for music from within the app itself -- they've had to search using OS-level tools. Microsoft is mending that gap in logic with the June update to its built-in jukebox software. The media play now lets you search for songs on both your PC and Xbox Music through an in-app button. And if you don't have any local tunes, you won't have to sign in to start listening -- Music now lets you stream 15 tracks through Xbox Music's ad-supported free tier without using an account. While there aren't other big upgrades to the app, what's here is enough to justify a trip to the Windows Store for the new version.

Filed under: ,

Comments

Source: Windows Experience Blog

Source: http://feeds.engadget.com/~r/weblogsinc/engadget/~3/WDtYv0qHso8/

Honey Boo Boo Psalms 91 once upon a time once upon a time RG3 nfl playoff schedule Rex Ryan tattoo

Tuesday, June 18, 2013

Obama: Spying Programs 'Transparent' (ABC News)

Share With Friends: Share on FacebookTweet ThisPost to Google-BuzzSend on GmailPost to Linked-InSubscribe to This Feed | Rss To Twitter | Politics - Top Stories News, News Feeds and News via Feedzilla.

Source: http://news.feedzilla.com/en_us/stories/politics/top-stories/313404989?client_source=feed&format=rss

taco bell Breezy Point Seaside Heights nj transit PSEG hocus pocus hocus pocus

Hoffa mystery still fascinates after 4 decades

Law enforcement officials from the Michigan State Police help search the area in Oakland Township, Mich., Tuesday, June 18, 2013 where officials continue the search for the remains of Teamsters union president Jimmy Hoffa who disappeared from a Detroit-area restaurant in 1975. (AP Photo/Carlos Osorio)

Law enforcement officials from the Michigan State Police help search the area in Oakland Township, Mich., Tuesday, June 18, 2013 where officials continue the search for the remains of Teamsters union president Jimmy Hoffa who disappeared from a Detroit-area restaurant in 1975. (AP Photo/Carlos Osorio)

Members of an FBI evidence response team look over an area being cleared in Oakland Township, Mich., Tuesday, June 18, 2013 where officials continue the search for the remains of Teamsters union president Jimmy Hoffa, who disappeared from a Detroit-area restaurant in 1975. (AP Photo/Carlos Osorio)

Law enforcement officials from the Michigan State Police help search the area in Oakland Township, Mich., Tuesday, June 18, 2013 where officials continue the search for the remains of Teamsters union president Jimmy Hoffa who disappeared from a Detroit-area restaurant in 1975. (AP Photo/Carlos Osorio)

FILE - In this Sept. 30, 1957 file photo, Jimmy Hoffa, Teamsters vice president and leading candidate to succeed Dave Beck as the IBT's new president, waves to delegates at the opening of the Teamsters Union convention at Miami Beach, Fla. Hoffa?s mysterious disappearance, assumed death and myriad searches for his body have been the stuff of urban legends for more than three decades and continue with the most recent report that the former Teamsters chief?s remains are buried beneath a concrete slab in a barn in a field in suburban Detroit. (AP Photo/File)

FILE - In this June 3, 1974 file photograph, teamsters president Jimmy Hoffa is shown in Washington. The Teamsters leader was last seen in July 1975 at a restaurant in Oakland County's Bloomfield Township in Michigan. Federal agents revived the hunt for the remains of Jimmy Hoffa on Monday June 17, 2013, digging around in a suburban Detroit field where a reputed Mafia captain says the Teamsters boss' body was buried. (AP Photo, File)

(AP) ? The latest possible resting place of Teamsters boss Jimmy Hoffa is an overgrown farm field where the normal calm of chirping crickets is being drowned out by a beeping backhoe, the chop of an overhead news helicopter and the bustle of reporters and onlookers.

Over nearly four decades, authorities have pursued multiple leads into Hoffa's death that yielded nothing. Yet the mystery endures, fueled by a public fascination with mobsters and murder.

"It's one of those things you've always heard about," said Niki Grifka, who, at 37, was just an infant when Hoffa vanished.

Over the past day and a half, Grifka and a few dozen other Oakland Township residents gathered a couple of hundred yards from where FBI agents wearing hard hats and carrying shovels sifted through about a half-acre of red dirt for the remains of a man who became as large in death as he was leading one of America's most powerful labor unions.

Hoffa's rise in the Teamsters, his 1964 conviction for jury tampering and his presumed murder are Detroit's link to a time when organized crime, public corruption and mob hits held the nation's attention.

Hoffa was last seen July 30, 1975, outside an Oakland County restaurant where he was supposed to meet with a New Jersey Teamsters boss and a Detroit Mafia captain. His body has never been found.

But over the years, authorities have received various tips, leading the FBI to possible burial sites near and far.

In 2003, a backyard swimming pool was dug up 90 miles northwest of Detroit. Seven years ago, a tip from an ailing federal inmate led to a two-week search and excavation at a horse farm in the same region. Last year, soil samples were taken from under a concrete slab garage floor north of the city. And detectives even pulled up floorboards from a Detroit house.

No evidence of Hoffa was found.

Other theories have suggested he was entombed in concrete at Giants Stadium in New Jersey, ground up and thrown in a Florida swamp or obliterated in a mob-owned fat-rendering plant.

Detroit's long tradition of organized labor and auto manufacturing means the Hoffa saga still resonates with countless Michigan families.

"Everyone has a connection with Hoffa and the unions," said 47-year-old George Newton, of Oakland County's Rochester. "I was in high school when he got abducted, and my grandfather was in the union."

To Newton, it would be exciting if Hoffa's remains are finally found, but he doubts that ever will happen.

"I just think it's a tightly held secret," Newton said. "I do want closure, first for Hoffa's family and, I think, in a way for Michigan."

The latest tip about Hoffa's remains came from a reputed Mafia captain Tony Zerilli, who, through his lawyer, said Hoffa was buried beneath a concrete slab in a barn in the Oakland Township field.

The barn is gone, but FBI agents pored over the field Tuesday for a second day. Forensic anthropologists from Michigan State University were bought in to help, along with state police dogs, which were led through the high grass in hopes that their sensitive noses might sniff out a clue.

Authorities suspended the search late Tuesday afternoon, but expected to resume their efforts Wednesday.

Zerilli, now 85, was in prison for organized crime when Hoffa disappeared. But he told New York TV station WNBC in January that he was informed about Hoffa's whereabouts after his release. His attorney, David Chasnick, said Zerilli is "intimately involved" with people who know where the body is buried.

Details are in a manuscript Zerilli is selling online, $7.99 for a mailed copy and $4.99 for an electronic version.

Zerilli's mob connections give his story more credibility than tips that spawned past searches, according to Keith Corbett, a former federal prosecutor.

"You have a witness who is in a position to know, who says he has specific information," Corbett said Monday.

"Anytime you look for somebody and don't find the body, it is embarrassing. The thing the public isn't aware of but police know is there are a lot of dead ends in an investigation."

Associated Press

Source: http://hosted2.ap.org/APDEFAULT/386c25518f464186bf7a2ac026580ce7/Article_2013-06-18-Hoffa%20Search/id-ee7509a397c249cbb9f2323bbfb2904d

nba playoff schedule rondo morris claiborne clippers lisa lampanelli lisa lampanelli bronx zoo

Sen. Cornyn Reveals Not One, Not Two, but Three Public Pensions Atop His Salary

Texas Republican John Cornyn supplemented his Senate salary with a trio of public pensions last year from his days as a Texas judge and elected official?a practice some fiscal watchdog groups have attacked as ?double dipping.?

Cornyn, who is the minority whip and the No. 2 ranking Republican in the Senate, reported collecting $65,383 in public retirement benefits in 2012 in addition to his $174,000 salary as a U.S. senator. ?

Cornyn?s office did not respond to requests for comment.

Elected to the Senate in 2002, Cornyn is a former district judge, Texas Supreme Court justice, and state attorney general. In 2012, he collected pensions from three separate state retirement programs.

The biggest of Cornyn?s pensions?$48,807? is from the Judicial Retirement System of Texas. He served on the state Supreme Court from 1991 to 1997.

He reported another $10,132 in retirement benefits last year from the Employees Retirement System of Texas?the pension fund for state elected officials and workers. Cornyn served as Texas attorney general from 1999 to 2002.

In a series of financial-disclosure amendments that he began filing last July, Cornyn disclosed that he had actually been collecting that $10,132 annual pension as far back as 2006. He had not listed it on his original disclosure reports from 2006 to 2010.

Cornyn also reported a $6,444 retirement distribution from the Texas County and District Retirement System. He was a state district judge from 1985 to 1989, according to his official bio, when the governor appointed him presiding judge for the Fourth Administrative Judicial Region of Texas, where he oversaw judicial administration for a 22-county region.

Cornyn, 61, is not the first or only prominent Texas Republican to draw both a public pension and a public salary. In December 2011, it was revealed that Texas Gov. Rick Perry was supplementing his $150,000 governor?s salary with a state pension of more than $92,000.

?I think it would be rather foolish to not access what you?ve earned,? Perry said in the midst of the 2012 presidential primary.

Cornyn, unlike Perry, is drawing his pensions and salary from different levels of government. His salary is supported by the federal government, while his pensions come from state and local government.

Cornyn is up for reelection in 2014.

Source: http://news.yahoo.com/sen-cornyn-reveals-not-one-not-two-three-151115404.html

geraldo obama trayvon martin pietrus cheney tori spelling marion barber marion barber