2015 International TechNet Wiki Summit 2015 Sandro Pereira From Forums to Wiki: Templates

 Senior Software Developer at DevScope and Microsoft Integration MVP since 2011  Member and co-founder of BizTalkCrew – BizTalk Innovation Day Events  Writer of numerous articles for Portuguese eMagazine “Programar”  Member of “BizTalkAdminsblogging.com” and “BizTalk Brasil” community  Member NetPonto community, MSDN BizTalk Forums Moderator  TechNet Wiki author (Wiki Ninja)  TechNet Gallery, Code Gallery and CodePlex contributor  Author book: BizTalk Mapping Patterns and Best Practices  Public speaker and Technical Reviewer of some books Sandro Pereira (Blog, twitter, website)Blogtwitterwebsite About 2 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Agenda 3 Why should we migrate content from forums? Forums + TechNet Wiki = Better together Best Practices for Converting a Forum Thread into a New Wiki Article Defining a common structure: Templates How can Templates can help you Wiki: Troubleshooting Template Format Wiki: Questions and Solutions Template Format Resource and more information Key Takeaways Q&A Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Why should we migrate content from forums? A good forum thread is one where the questioner gets a helpful response or answer… but sometimes: Forum thread can take different directions Some of them can have multiple problems and solutions Some of them can became very extensive There are a lot of similar forum threads They have a different audience 4 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Why should we migrate content from forums? One of the key point to migrate content from forums is: Community Synergy across TechNet Forums and TechNet Wiki Forums + TechNet Wiki = Better together Cross-links improving both contents TechNet Wiki have a new and different audience and in addition: Collaboration Maintenance 5 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Forums + TechNet Wiki = Better together Ed Price wrote a blog: Why create a TechNet Wiki article when you can just link to a forum thread?. 6 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Forums + TechNet Wiki = Better together Now here is what you'd do to create a Wiki article: You write up a fantastic solution in the forums. You copy and paste the problem statement into a new Wiki article; you tweak it.new Wiki article Then you copy and paste your solutions. You add a little more explanations. You make the title awesome so that it gets great SEO. Then you publish it and let the community help you keep it up to date (and maybe help fix any of your typos). 7 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Best Practices for Converting a Forum Thread into a New Wiki Article Explain the problem. Take your time to find the right solution, possible solutions, or/and related problems. Accuracy. Give Credits. Best Practices for Giving Credit in the TechNet Wiki Be careful copying content from external source Defining a common structure. 8 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP for-converting-a-forum-thread-into-a-new-wiki-article.aspx

Defining a common structure: Templates Have you seen a book with different layouts and different structures between different chapters? For me it is always a best practice to apply the same concepts in the TechNet Wiki. If we follow similar article structure, I believe the TechNet Wiki will be more consistent and the articles will be more easy to read/understand. For helping you accomplish that, you can apply one of the following templates: Troubleshooting template Questions template 9 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Wiki: Troubleshooting Template Format 10 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Wiki: Questions and Solutions Template Format 11 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Resource and more information  Best Practices for Converting a Forum Thread into a New Wiki Article practices-for-converting-a-forum-thread-into-a-new-wiki-article.aspx practices-for-converting-a-forum-thread-into-a-new-wiki-article.aspx  Wiki: Troubleshooting Template Format troubleshooting-template-format.aspx troubleshooting-template-format.aspx  Wiki: Questions and Solutions Template Format questions-and-solutions-template-format.aspx questions-and-solutions-template-format.aspx  Top Five reasons to use MSDN/TechNet Forums & TechNet Wiki together 3-five-reasons-to-use-technet-forums-amp-technet-wiki-together.aspx 3-five-reasons-to-use-technet-forums-amp-technet-wiki-together.aspx 12 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Resource and more information  Synergy in Social Computing social-computing.aspx social-computing.aspx  Wiki Life: Why create a TechNet Wiki article when you can just link to a forum thread? create-a-technet-wiki-article-when-you-can-just-link-to-a-forum- thread.aspx create-a-technet-wiki-article-when-you-can-just-link-to-a-forum- thread.aspx  TNWIKI - Wiki Life - How to Create Content for the Technet Wiki how-to-create-content-for-the-technet-wiki.aspx how-to-create-content-for-the-technet-wiki.aspx 13 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Key Takeaways 14 Templates helps you to define and follow a common structure They will provide the structure base from your article You can easily copy the structure to your new article Time saver: be focus in the content and not in the structure You can add new templates for all different topics Don't forget to give Credits and add cross-link between articles and forums threads. Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Key Takeaways 15 Don’t rush… Take your time to find the right solution, possible solutions, or/and related problems And help us to grow the TechNet wiki in terms of both content and quality by adding new articles based on Forums Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP

Questions? 16 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP sandroaspbiztalkblog.wordpress.com

17 Sandro Pereira: Senior Software Developer at DevScope; Microsoft Integration MVP