International TechNet Wiki Summit2015

Alan Carlos, Durval Ramos e Luciano Lima

Wiki Life: Boas Práticas

Agenda

2

• Criando um Artigo• Títulos e Seções• Formatação (Fontes, Códigos, Imagens,...)• Estrutura básica de um Artigo

• “Veja Também” ou “Referências”. Qual a diferença?• Tags... Sua importância para consultas• Assinaturas e outras Personalizações• Dê “Créditos” a quem merece• Traduções de Artigos... Amplie seu horizonte!!!

Quem somos nós

Durval RamosSQL Server MVP

3

Luciano LimaEnterprise Security MVP

Alan CarlosMCT - ALM

Criando um Artigohttp://aka.ms/wiki-ptbrAcesse o TechNet Wiki

para começar a colaborar

Clique em “Escrever um Artigo”Você poderá usar o modelo

“visual” ou “html”

Aberto à todos

Membros MSDN (desenvolvedores) e

TechNet (Infra e outros “IT Pro”)

4

Títulos e Seções

Seja “Objetivo”• O título do artigo determina a URL do artigo

• Facilita a pesquisa de outros profissionais

• Não é mais necessário adicionar a tag “pt-BR”

Utilize quantas Seções forem necessárias• Mantenha seu conteúdo organizado

• Planeje a melhor forma de compreender sua solução

• Em artigos curtos, avalie a necessidade e tenha bom senso

• Em artigos mais extensos construa uma “Estrutura Básica”

5

Formatando o artigoUtilize o “padrão”• Ajuda a leitura e a coesão de todos os artigos

• Mantem sua aparência uniforme

• A fonte é “Segoe UI, 12pts, Preto”

Cuidado ao destacar• Caso tenha necessidade de adicionar mais “importância” à uma informação, utilize os

“Modelos de Mensagens”

http://social.technet.microsoft.com/wiki/pt-br/contents/articles/13033.modelos-de-mensagens.aspx

6

Formatando o artigoImagens com Limite• O tamanho máximo para boa exibição de uma imagem é de 600px de largura

• Sempre adicione às imagens no TNWiki. Evite vínculos externos !!!

• Respeite à Privacidade e os direitos sobre a imagem

Scripts e Códigos de Projetos• Não é necessário “colorir” ou adicionar formatações especiais

• Você poderá utilizar ferramentas externas para melhorar sua experiência

7

Estrutura básica de um Artigo

Defina como explicar seu conteúdo• Em muitos casos, temos um “Começo”, um “Meio” e um “Fim”

• Procure detalhar como “refazer” esta solução

• Indique quem te inspirou (seção “Créditos”)

• Indique o que te inspirou (“Veja Também” e/ou “Referências”)

http://social.technet.microsoft.com/wiki/pt-br/contents/articles/21753.wiki-boas-praticas-para-referencias-e-citacoes.aspx

8

“Veja Também” ou “Referências”Qual é a diferença?

Ambos são importantes!!! Procure adicionar e compartilhar onde seu artigo foi inspirado.

Seção “Veja Também”• Lista de links na parte inferior do artigo para “ligar” artigos com assuntos relacionados

no TechNet Wiki

Seção “Referências”• Use esta seção para indicar a origem de suas idéias de outros Sites, Blogs ou Fóruns

• Certifique-se de que você tem permissão do autor para usar seu material

9

Tags... Sua importância para consultas• As tags auxiliam na busca de informações

• Elas podem ser utilizadas “encadeadas”

http://social.technet.microsoft.com/wiki/pt-br/contents/articles/tags/SQL+Server/Durval/default.aspx

Use tags de Tecnologias e para pesquisa no Wikihttp://social.technet.microsoft.com/wiki/pt-br/contents/articles/21520.technet-wiki-tags-de-tecnologia.aspx

http://social.technet.microsoft.com/wiki/pt-br/contents/articles/21535.wiki-tags-comuns.aspx

Lembre que você está em um “Wiki” !!!

Nossa premissa é o “trabalho colaborativo”, mas repudiamos a edição de artigos “sem valor” para informação do leitor

10

Assinaturas e outras Personalizações

Assim que um artigo é criado no TNWiki,

o autor estará marcado para sempre com a

Definição “PRIMEIRA PUBLICAÇÃO POR”

• Procure não adicionar informações pessoais

• Adicione “seus detalhes” em sua página de perfil

Procure incentivar às pessoas à “interagir” com seu artigo.

Atualizando (acrescentando) oualterando (formatação e/ou conteúdo)

11

Dê “Créditos” a quem merece

Muitas vezes nosso artigo foi inspirada:

• Por um livro

• Uma resolução nos Fóruns MSDN ou TechNet

• Sobre um post em Blogs Técnicos

• Outros artigos TNWiki

Faça a citação deste autor e indique a origem de sua “inspiração”

12

Traduções de ArtigosAmplie seu horizonte !!!

• Se você conhece outro idioma, mesmo que não seja “fluente”

• Aumente a visibilidade de seu artigo na Comunidade Internacional

• Em todos os artigos (original e traduzidos) deve existir a seção “Outros Idiomas”. Esta deve ser a última seção

• Adicione as tags: • No Artigo Original: “Multi Language Wiki Articles” e “has Other

Languages”

• Nos Artigos Traduzidos: “Translated into English” e “has Other Languages”

13

Obrigado !!!

Dúvidas ou sugestões:

http://social.technet.microsoft.com/Forums/pt-BR/home?forum=technetwiki

14