次の方法で共有


Wiki Life: Planning a Great Article

You have a great idea. You want to share it with the community. But will anyone read it?

A little bit of planning can be the difference between a good idea and a great article that will help the community. Here are a few tips for writing great articles.

1. What's the goal of the article?
2. Know your audience (reader)
3. Should it be one article or multiple (linked) articles?
4. Pre-Prepare everything (screen shots, code examples, videos, and the articles content)
5. Keep your article simple and get straight to the point
6. Use clear headings, short paragraphs and simple sentences
7. Write it out, read it through, spell check it, then try to condense it
8. Keep the formatting simple
9. Know the standard

1.
Think carefully about the information you are trying to share. Write it down as one or more bullet points (try to keep them to just a few). Refer to these points as you write your article. Anything that doesn't support these points should be removed.

2.
Who is the intended audience for your article? What will they be looking for? Are they business users? Analysts? Technical people? Think about what these people are like and what they'll be looking for.

Write your article in way that the reader (audience) will find easy to understand. Use words (language) your readers will be familiar with.

3.
You've got of a great subject to write about, but it is complex, very long, or has multiple concepts. Perhaps it would be better to write several articles, with each article containing one idea, linking them together with a See Also section? This may make your articles faster and easier to read through.

4.
Prepare everything for your article in advance. Take screen shots and save them to a folder. Write and test any code examples. Save sample files to the TechNet Gallery. Write out the article contents in a text editor, leaving spaces (or markers) for images and examples.

Doing this will help you plan the articles structure (the sentences and paragraphs, where code and pictures will be inserted, additional links, etc.). Planning your articles structure gives you time to consider the placement of text, pictures and examples.

5.
People are short on time. We search for information because we need to know something. Keep your article short and to the point; give the reader only what they need.

6.
Keep paragraphs short. Stick to one idea per sentence. Use headings that tell the story of your article. Doing this will make your article faster and easier to read.

7.
Write your article in a text editor. Read it out aloud. Does it make sense? Was it easy to read? Can it be shortened? Is the spelling correct?

If you can, leave it for a day, then come back and read it again. Does it still make sense? Does it clearly convey the subject you are writing about?

8.
Simple formatting is easy to read. Keep to standard styles. Keep the use of styles as limited as possible.

9.
Finally, know the current Wiki standards. There are many useful articles that provide guidance on content, structure, standards, formatting and more. Get to know them.

See Also:

TechNet Wiki: Getting Started
Wiki: User Experience Guidelines  *A really good article to read before getting starting
What Makes a Great Article

Comments

  • Anonymous
    January 08, 2014
    Great post Matthew. Thanks for sharing.
  • Anonymous
    January 08, 2014
    Matthew, all I can say is, "Amen!"I especially like tip # 2. That is one of the primary reason why I provide writing descriptions, screenshots and videos for my aritcles because readers absorb material differently.
  • Anonymous
    January 08, 2014
    Matthew, with your many Gold medals, actually you're one of the best writes on the WIKI!
  • Anonymous
    January 08, 2014
    Very nice tips!
  • Anonymous
    January 08, 2014
    A well structured and objective article makes the reader back more often in the article. In some cases, the reader begins to monitor all content that this author creates.Great post Matthew
  • Anonymous
    January 08, 2014
    Excellent and useful guide, Matthew. Good job!
  • Anonymous
    January 08, 2014
    Great post Matthew !
  • Anonymous
    January 08, 2014
    Thanks for all the really nice comments guys!
  • Anonymous
    January 08, 2014
    Dan, I completely agree with you. Knowing your audience, and writing in a style that suits them, is really important. I think you do great job with all of your screen shots and videos!
  • Anonymous
    January 10, 2014
    Must say nice post Matthew.Few points which every body knows but forget it .I will surely keep your article in parallel when creating a wiki post:)
  • Anonymous
    January 10, 2014
    Above commnents are mine
  • Anonymous
    January 10, 2014
    Great Post and Congrats on the first post !!
  • Anonymous
    January 10, 2014
    Pingback from Blog x TechNet Wiki ??? Diferen??as na publica????o de um artigo | Ana Paula de Almeida
  • Anonymous
    January 11, 2014
    Thanks Matt, great summary!
  • Anonymous
    January 12, 2014
    Matthew, you beat Durval by two days! Great first post! http://social.technet.microsoft.com/wiki/contents/articles/14459.wiki-ninjas-blog-the-contributors.aspx#Current_Contributors
  • Anonymous
    January 13, 2014
    Thanks guys!
  • Anonymous
    January 22, 2014
    As a general rule, people come to the Wiki looking for specific information, with a limited amount of
  • Anonymous
    January 22, 2014
    As a general rule, people come to the Wiki looking for specific information, with a limited amount of
  • Anonymous
    February 12, 2014
    Perfect article. I will translate for Turkish Language. Thank you
  • Anonymous
    February 12, 2014
    Thank you Mr. Matthew.
  • Anonymous
    February 19, 2014
    Ctrl+C and Ctrl-X are one of the most used key combinations on my keyboard (only just out ranked by Ctrl
  • Anonymous
    March 05, 2014
    There is a saying, "A picture is worth a 1000 words". I'm sure you've heard the idea
  • Anonymous
    March 13, 2014
    This blog is a follow up to our last list of Wiki Ninja Blog Authors: Council Spotlight: Who are the
  • Anonymous
    March 16, 2014
    Using code, markup or command examples in your Wiki articles can be very helpful to readers. Examples
  • Anonymous
    April 25, 2014
    congratulations
  • Anonymous
    July 09, 2014
    Hello Community!
    Today is Wiki Life and I'll talk about the Blog for TechNet Wiki (Wiki Ninjas
  • Anonymous
    July 17, 2014
    Congratulations
  • Anonymous
    August 20, 2014
    Earlier this year I wrote a series of posts about writing good articles. It's been a while since
  • Anonymous
    September 27, 2014
    Thank you,
  • Anonymous
    November 05, 2014
    Hello most valuable Wiki family,
    I am calling Wiki family because we are really very big family. In
  • Anonymous
    March 03, 2017
    Excellent text. .