• Wiki Life: The Principle of Invisibility

    When i started contributing in Wikipedia in 2006 there were not many articles with principles and policies. The Wikipedia evolves very much and today we find many guide to the best practices to contribute to the Wiki.

    One of the principles that are presented is the use of signatures in the articles.
    "When editing a page, main namespace articles should not be signed, because the article is a shared work, based on the contributions of many people, and one editor should not be singled out above others." - Wikipedia: Signatures

    Unlike Wikipedia, many of the TechNetWiki's articles were first written in Blogs and later migrated to the Wiki. During this migration (of content and culture) many habits that had brought us into the TechNetWiki blogs.
    One of these habits is signing on articles. Increasingly i found articles with signatures. But this would be a habit or a trend?

    Wikipedia doesn't present the question of signatures as a "Principle of Invisibility," but i think of it this way. "Who" should receive the biggest highlight in an article in a wiki is article itself and the information it contains.

    If we observe the Wikipedia articles, the articles are written in a way very impartial. Instead of writing "In this article i'll talk about," we would find "In this article you will find information about ...".

    When i creating an article in a Wiki I always think it's the beginning of a collaborative work and if I want more people to contribute, i need to worry about writing in a way that at any time, any paragraph or sentence somebody can include an information.

    I not found something in the TNWiki documentation regarding the use of personal signatures. But whenever someone asks me to help migrate an article from a blog to Wiki, i try to follow the principle of invisibility and I advise new contribuites to be as unbiased as possible so that there is always room for new content / information from other authors in the article. 

      
     
     Ana Paula de Almeida 
    TechNet Profile | anapdealmeida.com | @anapdealmeida


    See Also

  • Interview with a Wiki Ninja: Joe Davies, Microsoft Technical Writer for SharePoint 2013, Windows Server, and the Test Lab Guides

    Welcome to our Monday Interview with a Wiki Ninja!

    Today's interview is with Joe Davies, technical writer on the SharePoint platform and architecture, formerly on Windows Server, and a key leader in our Wiki efforts around Test Lab Guides and Learning Roadmaps.

    Joe Davies's avatar

    Who are you, where are you, and what do you do? What are your specialty technologies?

    I am a Principal Writer in the SharePoint Platforms and Infrastructure writing team, working on the Redmond campus of Microsoft. I am responsible for authentication and identity management content for SharePoint 2013 and 2010, including new hybrid configurations that share data between an on-premises SharePoint 2013 farm and a SharePoint farm in Office 365.

    In the past I have been a writer, trainer, and instructional designer for Windows Server, where I specialized in Windows networking technologies including TCP/IP, IPv6, IPsec, virtual private networks, wireless networks, and network access protection. For a list of my Microsoft Press books, see my Amazon.com page. I also wrote The Cable Guy column from 2000-2010.

     

    What are your big projects right now?

    Two big areas of interest for me right now are the expansion and integration of more graphical elements in content and efforts to develop and define troubleshooting content.

     

    What do you do with TechNet Wiki, and how does that fit into the rest of your job?

    I primarily use the TechNet Wiki to publish articles that would either benefit from direct community collaboration or are designed to enable the community to create their own articles. For example, for the Test Lab Guides, I have published a series of template articles and examples that allow the community to more easily create Test Lab Guide content.

    I also use the TechNet Wiki to publish content that serves a specific niche function—such as FAQs or specialized portals—or for content that applies to multiple versions of products.

     

    What is it about TechNet Wiki that interests you?

    As a full-time technical writer at Microsoft, there is just not enough time to learn and experience all aspects of a product or technology. By its very nature, the type of content that I have time to write and publish is somewhat theoretical, reflecting well-defined and recommended uses and configuration.

    However, customers typically take our products in directions we never imagined. The TechNet Wiki allows those working in the wild to add their voice and provide input on experiences, priorities, configurations, and best practices for a more complete documentation set that reflects real-world deployments.

     

    On what Wiki articles do you spend most of your time?

    I spend most of my time on the articles in the Test Lab Guides ecosystem, which includes portal pages, templates, examples, and test lab content. I also help maintain a set of SharePoint portal pages, ensuring that they reflect the content that the SharePoint team here at Microsoft publishes and other SharePoint community content.

     

    What are your favorite Wiki articles you’ve contributed?

    Some of my favorites include the Test Lab Guides and Learning Roadmaps portals. They provide an overview of what the content is trying to accomplish, links to content, and links to template articles that allow the community to create their own content.

     

    What does success look like for TechNet Wiki?

    Success for the TechNet Wiki is broad awareness as an authoritative repository for technical content and the ongoing and active contribution of content from an engaged community. IT pros using Microsoft products should know that they have a voice and a place to easily contribute their technical knowledge and experiences.

    ================================

     

    Special thanks to Joe Davies for the interview!

    What do you think of Joe's articles? Do you have any additional questions for Joe? Leave a comment below!

     

    And remember to... Wiki While You Work! (or after work)

    - Ninja Ed

     

  • Community Win: User Experience Guidelines

    Hello and welcome everybody to our Thursday - Community Win.

    A lot has changed since the old days back in the early 90s, especially in the IT world. Go back with me into this time just for a moment. What was the appearance of computer programs at this time? Normally it was executed in an ugly black console. As a user you needed some knowledge to work with these programs. What has changed since these days? Of course, you could say that programs looks nicer, but there is one thing that has changed dramatically (as part of programs which looks nicer): the user experience. Since the iPhone/iPad and Windows 8 user experience is the holy grail to satisfy your users.

    What has this to do with our wiki?

    Beside the information you provide in your articles the appearance is an important part of a good article. The ninja guru Ed Price has started an article about the User Experience Guidelines for the wiki. It will help you to transform your article into a master piece. It starts with guidelines about casing rules and gives information about fonts, page layout, links, tags, and many more. Why should I care about all these things? It will help other community members to find information faster and it creates an equal experience throughout the wiki.

    - German Ninja Jan (Twitter, BlogProfile)

  • Wiki life: fight for your right to aaaaaau...author!*

    Have you ever thought about your copyright on the articles you publish on Technet Wiki, or on other Wiki platforms or other code sharing platforms like Microsoft's Codeplex or open source platform Sourceforge?
    What's the consequence of using Technet Wiki for publishing code samples like powershell scripts?

    Have you ever read the small print?

    A while ago, the following situation happened with powershell code published on your beloved TechNet Wiki platform.
    (Names have been changed and anonymized to protect the innocent.) 

    An MVP posted a powershell script. A company A ("Defendant") on the other side of the ocean used it in their product.
    Some time later another company B ("Plaintiff") from the other side of the world sued the company A for using their scripts.
    That means that the company either used the MVPs script as well and the person who grabbed it, doesn’t want to admit it, so company thinks they created it.
    Or it means that the dev and the MVP just had the same great idea (which happens a lot, to be honest).

    On TechNet Wiki, copyright is handled by the TNWiki Terms of use.
    You can find the small print on the footer of the TNWiki main page or any Wiki page.

    "ACCEPTANCE OF TERMS OF USE

    Microsoft provides you with access to a variety of resources on this web site, including documents, photographs, videos, and other graphical, textual or audio-visual content (“Content”), software and computer code, including developer tools and sample code (“Software”), and communication forums and other services ("Services").  The Content, Software, Services and all other aspects of this web site are subject to these Terms of Use.  Microsoft reserves the right to update these Terms of Use at any time without notice to you.  The applicable and most current version of the Terms of Use can be reviewed by clicking on the “Terms of Use” hypertext link located at the bottom of our web pages.

    By accessing or using this web site in any way, you agree to and are bound by the terms of this Terms of Use.  If you do not agree to all of the terms and conditions contained in the Terms of Use, do not access or use this web site.

    A bit further in the Terms of Use, you'll read:

    "SUBMISSIONS PROVIDED TO THIS WEB SITE

    Microsoft does not claim ownership of code, content, comments, feedback, suggestions, information or materials that you provide via this web site or any Services ("Submission"). However, by providing a Submission, you are irrevocably granting Microsoft and its affiliated companies the right to make, use, modify, distribute and otherwise commercialize the Submission in any way and for any purpose (including by granting the general public the right to use your Submissions in accordance with this web site’s Terms of Use, which may change over time), and the right to publish your name, city of residence, and e-mail address in connection with your Submission.  These rights are granted under all applicable intellectual property rights you own or control.  

    No compensation will be paid with respect to the use of your Submissions. Microsoft is under no obligation to post or use any Submission, and Microsoft may remove any Submission at any time.

    By providing a Submission you warrant that you own or otherwise control all of the rights to your Submission and that your Submission is not subject to any rights of a third party (including any personality or publicity rights of any person). "

    And also

    "2. Grant of Rights

    (A) Copyright Grant - Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create."

    Just for your reference,

    When discussing the case with the Master TNWiki Ninja he explained it as follows.

    Copyright on the TNWiki is handled just like blogs or forums. You can only publish your own content (or content owned by Microsoft).
    When you do that, you’re granting Microsoft to use your content in the social context. But you aren’t losing your copyright. You’re just granting permission of use.

    It seems that such a case happened a few times before...
    The result was that parties were offered to reach an agreement as to what the content on the Wiki should be and in some cases the content was deleted.

    How could you solve the case as described earlier?

    Removing the content is an option. Legally speaking.
    But that's not the end of the story. 
    You could ask to have a sample of their content on the Wiki with a link back to the full article (and a note about what content was granted with permission by the author).
    This can be done in the same Wiki article, or a new article can be created to do this.

    We should also recommend you do not sue each other, since we are talking about a context of a social world where content belongs to everyone.

    Just in case the "owner" doesn't want the code freely used, don't publish it on social or community media first of all, but alternatively it's recommended that the owner publishes the code on his own blog.
    He should move his blog to his own site (versus a provider), where he can disable the ability to copy content.
    Because this is the best way to prevent anyone from copying your content when you publish it online for anyone to copy.

    Quoting the Master WikiNinja: "You can sue anyone over anything".
    But that's not the spirit of a Wiki Ninja!

    Don't forget the TNWiki is an open, social and collaborating community which requires respect for someone elses content!

     

    [Ka-jah Shakaah!]
    The Security & Identity Ninja.



    Peter Geelen     
    peter@fim2010.com
    Premier Field Engineer - Security & Identity at Microsoft
    CISSP, CISA, MCT

    (*) Free interpretation of old school music

  • Wednesday: Wiki Life who gave most gifts?

    So, this blog post was supposed to be on Wednesday, but somehow I thought it was last week, so don't be scared, it's not Wednesday it's just a late post from Wednesday! I blame it on the fact that I was awarded the MVP January 1 this year.

     

    So I wanted to see who would give us the most gifts this Christmas, by adding the tag "Christmas Gift" (English, Brazil).

    Any a few did!

    So what is the Gift, I will highlight you and give you somewhat of 150 Words of pure bragging!

     (2 articles as Christmas gifts)

    EXTREMES in fortune, health and spirituality. You are very versatile, idealistic and intuitive. You enjoy great success. The solution is service to others. Use your leadership abilities for humanity. You are bold, independent, inquisitive and interested in research. You know what you want and why you want it. If A is the first vowel and there are two A's in the entire name, you are a clear thinker. If A is the first vowel and there are more than three A's, you can be even more clear. 

    You find the best contentment in life when you own your own home and provide well for your family and loved ones. You have a great sense of responsibility and duty. You are comforting, appreciative and affectionate. Your obligation in life is to hold justice and truth, and since you follow the Law, you find greater happiness and satisfaction.

    yottun8 (1 article as a Christmas gift)

    I know you real name is Tomoaki, so here are some bragging for you!

    You develop high spirituality, as you have a God's protection. You are sensitive, affectionate, imaginative and cooperative, spiritually aware and prone to self-sacrifice. You can keep secrets and are a good diplomat. You are frank, methodical and believe in law, system and order.Creative and outgoing, you are always looking for an opportunity to show your abilities, especially before an audience. You are very flexible and likes to feel appreciated. You are looking for chances to mix with others socially and to communicate his ideas. You like to talk and can easily relate to different cultures and concepts.

     

    Ed Price (1 article as a Christmas gift)

    You are more attracted to the wordlier than to the spiritual Except for Ninjas but they are real. You are entertaining but may be impulsive. Freedom is a necessity, but you don't find it difficult to settle down to specialize. Your versatility results in many changes, and often bring travel. Your fine intellect has brought you high honors. If you are drawn to the spiritual, you become idealistic, hopeful and intuitive. You are capable of inspired thinking applied to material things. You have an ability to learn and profit from the experience. You can be restless, changeable, and very sexy :Pl. You have an eventful, exciting life. You are versatile and have the ability to learn easily, but never nervous or temperamental. In critical situation you always keep a cold head. 

    You desire to inspire and lead, which we are happy that you do. You are giving, courageous and bold, action oriented,energetic and strong willed. You want to make a difference in the world, and this attitude often attracts you to cultural interests, politics, social issues, and the cultivation of your creative talents.

     
    I must admit I cheated a bit and rewrote some of the stuff from this page: What does my name mean?
     
    Happy belated Wednesday!

    Norwegian Ninja Tord (Blog, Twitter, Wiki, Profile)