• Wiki Life: Introducing Power Wiki - How to search TechNet Wiki content within the PowerShell console

    Well, I'm introducing it to you if you haven't received a proper introduction yet.. But that's the only exception.

    Hey. Welcome to Wiki Life Wednesday!

    Today we're going to take a look at a sweet Gallery script from Microsoft employee, Anil Erduran:

    Anil Erduran's Profile

     

    You can also check out Anil's website here: anilerduran.com

    Here is the script, which you can download from TechNet Gallery:

    PowerWiki - Search TechNet Wiki content in PowerShell

     

    PowerWiki is a very simple module to search Technet Wiki content within the PowerShell Console.

    The Module can be installed manually by downloading and extracting files in;

    •        %USERPROFILE%\Documents\WindowsPowerShell\Modules
    •        %WINDIR%\System32\WindowsPowerShell\v1.0\Modules

    Now you can import the module with the following command:

    Import-Module PowerWiki

    The Module includes the single function “PowerWiki”. When you are working with your local PowerShell console, simply call the PowerWiki function with a keyword that you want to search for on Technet Wiki.

    It pops-up Internet Explorer and goes to the exact wiki page.

     Again, go check it out and download the script here, from TechNet Gallery:

     

    PowerWiki - Search TechNet Wiki content in PowerShell

     

    Thanks to Anil for this fantastic solution, and make sure you check out TechNet Wiki. You know. Everyone's wikiying. Only the non-Wikiers aren't. They're the only ones.

         - Ninja Ed (Blog, Twitter, Wiki, Profile)

  • Creating Return to top links for TechNet Wiki articles

    One of the things that I like to provide (and see used) for longer TechNet Wiki articles are Return to top links. These are useful when an article is longer than just a section or two. I typically think about using the Return to top links when I feel it necessary to create a table of contents for an article. Speaking of which, Peter Geleen started a TechNet Wiki article "How to Automatically Add a Table of Contents (TOC) to Your Wiki Article" that includes a discussion on using Return to top links.

    The process is relatively quick. These are the essential steps:

    1. Create a Top link in your article. I like to select the first word of the introduction paragraph to the article.
    2. Select that word or location that is your target for the link and then click the Insert Link or Anchor icon.
    3. On the Anchor tab and then type a name for the link. I usually type top for mine.
    4. Next, determine where you want to place your Return to top links in your article.
    5. Create the link text by either typing Return to top or copying and pasting some fancier looking version, like: ↑ Return to Top
    6. Select your Return to top text and then click the Insert Link or Anchor icon again.
    7. On the Hyperlink tab, in Existing Anchor, select the name of your link. You might also type something like "Return to top of article" as a Tooltip. Then, click OK.

    Repeat steps 5 through 7 for every additional Return to top link that you want to create in your article.

    The following video demonstrates adding Return to top links into a TechNet Wiki article:

     

  • Interview with Rick Saling: SQL Server Senior Programming Writer on Entity Framework

    Welcome to the Monday Interview with a Wiki Ninja! As the title directly implies, this week we're interviewing a Senior Programming Writer who has been writing very deeply on the topic of Entity Framework...

    Rick Saling - MSFT

     

    From Rick's bio: "Senior programmer writer: Entity Framework. Previously I worked on the Oslo M language, and before that on WCF. I've also written an internal documentation automation tool. Prior to becoming a Microsoft employee, I was a contractor, designing SQL Server databases, and web applications. Prior to that I did many other things for many years." 

     

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

    I’m a senior programmer/writer in Redmond, and prior to that I was a developer for a long time. I write about SQL Azure, and Entity Framework. I also got to develop an internal automation tool, so between that and writing code samples, I’m somewhat split between the writer and developer roles.

     

    What are your big projects right now?

    I’ve been contributing to the Windows Azure Prescriptive Guidance section on MSDN (Developing SQL Azure Applications) in collaboration with folks from Microsoft’s Customer Advisory Teams. Currently I’m working on a paper about Windows Azure Performance.

     

    Besides your work on TechNet Wiki, where do you contribute?

    I have a blog at http://blogs.msdn.com/b/rickatmicrosoft, MSDN Library of course, as well as less active blogs, and Twitter.

     

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

    I moved the Entity Framework FAQs over to the Wiki in order to make it easier for community folks to update them.

    I experimented with translating some of the questions into Spanish, using the automated translation widget, and then finalizing it by hand.

    Lately, I’ve been experimenting with publishing things first on the Wiki, and then later on the MSDN Library, in order to show folks an “early release” of an article and in order to collect feedback. This obviously only works on released products, and not those under NDA.

     

    What is it about TechNet Wiki that interests you?

    I think it’s a great experiment in getting the community involved in creating “semi-official” information about Microsoft products. We try to design products (and write documentation) based on how we think customers will use our products (and documentation). We do our best to figure that out, but the real test is what customers themselves come up with. Customers know their businesses in much more detail than we do, and the way they use our products reflects that. So we entirely expect that customers will come up with problems and answers to them that we could not have anticipated. I see the Technet wiki as a great way for the community to share these kinds of insights.

     

    ==========

    Special thanks to Rick Saling for his work on TechNet Wiki, in Entity Framework, and in the Spanish community efforts on TNWiki. You can check out Rick's MSDN blog here.

    If you have any questions or thoughts for Rick, leave them below!

     

    When the going gets tough, the tough gets Wiki.

       - Ninja Ed (Blog, Twitter, Wiki, Profile)

  • Who Translates the Most on TechNet Wiki? Portuguese VS German VS French VS Japanese VS Spanish VS Italian (ready? fight!!!)

    Welcome to Friday - International Update.

    What do you get when you combine 102 articles translated by 15 authors into 6 languages (German, Italian, Portuguese, French, Japanese, and Spanish)? You get the power of collaboration on TechNet Wiki!

    It's time for an all out battle to see which language is translating the most TechNet Wiki articles into their language! Let's do battle!!!

    So again all the links here are to non-English articles that have been translated into English or from English. See all the English articles that were translated into one or more languages here: http://social.technet.microsoft.com/wiki/contents/articles/tags/Multi+Language+Wiki+Articles/default.aspx

    Portuguese (Brazil)

    Total: 15

    Wiki Ninjas:

    Articles:

    German

    Total: 33

    Wiki Ninjas:

    Articles:

    French

    Total: 13

    Wiki Ninjas:

    Articles:

    Japanese

    Total: 12

    Wiki Ninjas:

    Articles:

    Spanish

    Total: 4

    Wiki Ninjas:

    Articles:

    Italian

    Total: 25

    Wiki Ninjas:

    Articles:

     

    Winner

    The current winner is German, with 33 articles! This round might be over, but the battle isn't over yet!!!

     Special note: A lot of Spanish work was done around Entity Framework and isn't organized yet: http://social.technet.microsoft.com/wiki/search/searchresults.aspx?q=entity+framework

     

    See Also

     

  • Interview with Dr. Thomas W Shinder–Former MVP, ISA/TMG Firewall Guru, DirectAccess Edge Man and Now Private Cloud Man and Wiki Devotee

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

    I’m Tom Shinder. Some of you might know me from my www.isaserver.org days. Prior to changing my career to IT in the middle 1990s, I was a neurologist. I received my undergraduate degree in Psychology from the University of California, Berkeley and graduated with Great Distinction. I then went to the University of Illinois Chicago College of Medicine, where I received my Doctor of Medicine (M.D.) degree. After that I did an internship in Internal Medicine at the University of Texas, Galveston. The next step was a three year stint doing a residency in Neurology at the Oregon Health Sciences University (or OHSU, which has since changed its name to the Oregon Health and Sciences University).

    After that I practiced general neurology for several years. I left medicine because I saw the writing on the wall and a future of socialized medicine in the United States, where I would have to carry out the wishes of faceless bureaucrats when making treatment decisions. I didn’t think that would be good for me or my patients at the time, and so I left for IT – which seemed like a very green field at the time. Who would have known that it would turn out to be quite as green as is for me!

    I live together with my wife, Deb Shinder, in the Dallas/Forth Worth area in Texas. While I’m a native Californian, I consider myself a naturalized Texas citizen.

    When I joined Microsoft, I was initially with the UAG DirectAccess team. That was a great experience and I had a couple of great managers when working on that team and I owe them a debt of gratitude for training me in the Microsoft way of doing things – they were very patient with me. I was very happy with what we were able to accomplish and I had a great time being the “Edge Man” during those DirectAccess days.

    About a year later, I was moved to a new team, called the Server and Cloud Division Information Experience Solutions Group. In that group I work on private cloud, with an initial focus on private cloud architecture and private cloud security. I again got luckier than a four leaf clover by landing another great manager and a great topic – the future of IT is in cloud, and specifically in cloud architecture and that’s what I do. You can see the results of our work in the collection of documents that you can access from the Private Cloud Solutions Hub.

    I am also working working on content that is part of the cloud technologies Windows Server 8 scenario. You can find our stuff regarding Windows Server 8 cloud technologies over in the TechNet Library and the new Cloud Infrastructure Team blog. I also keep my own Private Cloud Man Blog where I’ll write about private cloud and Windows 8 Cloud Technologies.

    My specialty technologies, or at least those that I think I know a lot about include:

    • ISA Server (ISA)
    • Threat Management Gateway (TMG)
    • Unified Access Gateway (UAG)
    • DirectAccess
    • Virtual Private Networking (VPN)
    • IPsec
    • DNS
    • DHCP
    • IPv4 networking

    Moving forward, I am working on gaining experience in Windows Server 8 Hyper-V, Windows Server 8 cloud technologies, and System Center Virtual Machine Manager. I’ve been a big fan of virtualization ever since testing the very first beta version of VMware. So the move to virtualization is a natural for me.

    How did you become an MVP? Do you have any suggestions for other community members who hope to eventually become MVPs?

    I think I was awarded the MVP because of the work I did on www.isaserver.org and all the books I wrote on ISA Server. I think I have over 600 articles on ISA Server and TMG on the ISAserver.org site and I wrote about 7 books on ISA Server and TMG. In the early days, I did post a lot to the ISA Server TechNet forums and had over 50,000 posts on the ISAserver.org forums. I believe that I was an MVP for about 7 or 8 years before I joined Microsoft.

    For anyone who is interested in being an MVP I recommend that you stay connected to the technology community. Participate in the forums on a daily basis. Write a blog and update it at least once a week. Use Twitter and Facebook and LinkedIn to let people know about your work. Author a book on your product or technology, or partner with others to write a book. Present at Microsoft conferences, like TechEd. Connect to people who work for Microsoft in your chosen product or technology. We really want to work with you and develop a working relationship! That makes it easy for us to nominate you for MVP and say why we believe you would be a great MVP.

    What is TechNet Wiki for? Who is it for?

    The TechNet wiki is a collaborative writing environment where anyone who is registered with a Windows Live ID can create a new article, or edit and contribute to an existing article. There are few restrictions on what you can write, and as long as you write about some Microsoft product or technology with the aim at helping or educating people, you’re in the right place.

    I at first had some concerns about the wiki and that a wiki would add little value, if any. I can honestly say that I’ve eaten crow on that one, because now I see the wiki as a tremendous platform that we can use to work together with the Microsoft partner and customer community to get information that you need out faster, and with higher quality and fidelity than we currently do using the traditional TechNet Library approach. In fact, my team uses the TechNet Wiki to publish all of its material in a continuous and iterative publishing process.

    The TechNet Wiki is for anyone who’s interested in Microsoft products and technologies. Examples of people who will benefit from the wiki include:

    • Someone searching for information they can’t find in the TechNet library or blogs
    • Someone wanting to share information they’ve learned from experience which you can’t find in the TechNet library or blogs
    • Microsoft employees who want to collaborate with partners and customers on content
    • Microsoft partners and customers who want to collaborate with Microsoft employees on content
    • Microsoft product groups who want to share information on their products and technologies in a low overhead, low friction publishing environment
    • Anyone who is interested in working together with other product or technology devotees to share information with others

    And many more! The wiki is such as flexible and easy to use platform, the use case scenarios are almost limitless!

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

    All of my team’s work is published to the TechNet wiki. In most cases, we start writing on the public wiki and inform people who are working with us on the content that the content is available for editing and updating. We track the updates so that we’re aware of who’s making the changes and what the nature of the changes are. After the content is deemed “version X” we’ll mark it at that version and include a link to the golden version. The content is also converted into Word .doc format after it’s versioned and posted to the TechNet gallery. Both the wiki and the gallery are ideal mechanisms for enabling collaborative content development and provide an insanely low overhead way of creating and distributing content. The time saved in the overhead has enabled us to create more and higher quality content than what we could have ever done otherwise.

    If you would like to see our content portfolio on the TechNet wiki, then check out Reference Architecture for Private Cloud.

    Do you have any comments for product groups about TechNet Wiki?

    Yes! I encourage Microsoft Product Groups to seriously consider putting their documentation on the public wiki as soon as they can. I believe that user satisfaction with our product and technology guidance would be much higher if we could get customer input as soon as possible. This early input would make it possible to reassess our content plans early, and if we find that we’re not providing the information that customers actually want and need. This enables us to avoid wasting cycles on low return content and focusing on high value content from the very beginning. And the entire process will be transparent, so that our partners and customers are fully aware of the fact that working together with them to give them the information and tools they need to get the most out of our products and technologies.