Este é um trabalho que está em andamento. As Diretrizes Experiência do Usuário, existe como um esforço para estabelecer consistências básicas no TechNet Wiki. As diretrizes são realizadas de formas manuais, ou seja, (você mesmo tem que fazer as mudanças) e um dos objetivos em criar diretrizes manuais é, eventualmente, transformar algumas delas em orientações automáticas (que ocorrem automaticamente através de ferramentas). Desta forma, se reduz a edição e a comunicação em torno das orientações a serem seguidas. Neste artigo:



Títulos e subtítulos

O título do artigo determina a URL de endereço do artigo. Por exemplo, um artigo é titulado "Wiki: Guia de Estilo", o que resulta em uma URL de http://social.technet.microsoft.com/wiki/contents/articles/wiki-guia-de-estilo.aspx . Observe que os espaços tornam-se '-' e personagens como. ':' São ignorados ao criar a URL de endereço para um artigo Para mais detalhes, consulte as Diretrizes Título Wiki.

  • Caixa
    • Use um título de capitalização, ao invés do contrário.
      • Bom exemplo: "Orientações na experiência do usuário"
      • Mau exemplo: "Diretrizes na Experiência do Usuário"
    • Não use letras maiúsculas.
      • Mau exemplo: "Diretrizes Experiência do Usuário"
    • Capitalize a primeira letra da palavra depois de um hífen.
      • Exemplo: "Instruções - baseadas em cenários"
      • Mau exemplo: "Instruções baseadas em cenários"
    • Ao citar uma mensagem de erro em um título, você pode usar caixa sentença (ou o que está na mensagem de erro) e, colocar a mensagem em citações.
      • EXEMPLO: Analysis Services Solução do problemas: 10038 - "Um tempo limite ocorreu A interface não pode ser ativado.".
    • Marca "para" e "com" minúsculas.
      • Exemplo: "Como instalar o Windows 8"
      • Mau exemplo: "Como instalar o Windows 8"
  • Verbos  
    • Use tempo presente, em vez de:
      • "How Do I. .." (Isso é muitas vezes usado para ensinar um padrão ou expectativa de usuários, o que só poderia se deparar com tão confusa ou inconsistente.) 
      • Gerúndios, como "A restauração de um arquivo".
      • "How to ..." (Isto pode ser confundida com "How To" artigos que poderiam dar aos usuários noções preconcebidas de processual, o conteúdo passo-a-passo.)
    • A única exceção é quando o gerúndio gerúndio funciona como um substantivo.
      • Exemplo: "SSRS Solução de problemas: Instalação"
    • O objetivo é correr o risco de imprecisão e focar os verbos e substantivos para explicar o tipo de conteúdo.Por exemplo, "Registe-se um Usuário" deve dizer-lhe que um artigo é mais processual do que "Projetar um processo de implantação."
    • Ao arriscar imprecisão, ganhamos consistência, profissionalismo e clareza, com foco no conteúdo do que estamos apresentando, ao invés de tentar ensinar-lhes o que as nossas palavras adicionais significam sobre o conteúdo (como tentar diferenciar "Como Registe-se uma Usuário "de" Concepção de um processo de implantação "- o resultado é justo que nós olhamos inconsistente).
    • EXEMPLO: "Restaurar um arquivo"
    • Maus exemplos:
      • "Como faço para restaurar um arquivo"
      • "Restaurando um arquivo"
      • "Como devo restaurar um arquivo"

Substantivos / Temas

  • Use apenas o substantivo e adjetivos. 
  • Não incluem: 
    • "Algumas dicas sobre ..."  
    • "Como compreender ..."
    • "Introdução ao ..."
    • "Entender ..."
    • "Sobre ..."
    • "... Overview" 
  • EXEMPLO: "SQL Server 2008 R2"
  • Maus exemplos:
    • "Entendimento SQL Server 2008 R2"
    • "Algumas dicas sobre SQL Server 2008 R2"
    • "Como compreender o SQL Server 2008 R2"
    • "Introdução ao SQL Server 2008 R2"
    • "Sobre o SQL Server 2008 R2"
    • "R2 Visão geral do SQL Server 2008"
  • Veja Layout da página abaixo. A visão geral / artigos conceituais dar a perspectiva de alto nível e aprofundar-se um nível de fácil digestão. Mais perfurações deve ser feito através da criação de mais artigos que são específicos para o tema.
    • Por exemplo, em vez de usar títulos como "Introdução ao SQL Server" e "SQL Server para Experts", você começa cada visão geral / artigo conceitual com a introdução e drill down para um nível de fácil digestão.Em seguida, você especifica que os temas são especialistas e ligar-se a eles.
  • Primeira pessoa
    • Evite artigos de primeira pessoa em sua títulos como "eu" e "mim"
    • Exemplo: "Como instalar o SQL Server"
    • Mau exemplo: "Como eu instalado o SQL Server"
  • Perguntas
    • Evite perguntas no título.
    • Não incluem:
      • "Caso I. .."
  • Nome do produto prefixos
    • Opcionalmente, é possível adicionar a sigla ou uma versão abreviada do seu nome do produto antes de muitos artigos, a fim de esclarecer a tecnologia que o artigo é para.
    • EXEMPLOS:
      • "FCS: MOM Unidos Client"
      • "DAX: Funções estatísticas"
    • Incluir "Wiki: ..." antes de qualquer título do artigo sobre TechNet Wiki.
    • EXEMPLOS:
      • "Wiki: Experiência do Usuário Diretrizes"
      • "Wiki: Portal de Gestão"
  • Pontuação e símbolos
    • Não use símbolos, tais como:
      • Pontos de interrogação (?)
      • Ampersand (&)
    • Depois de começar com o nome do produto, use dois pontos (:) em vez de um traço (-).
      • EXEMPLO: "AD FS 2.0: Como restaurar sua sessão"
      • Mau exemplo: "AD FS 2.0 - Como restaurar sua sessão"
  • Vírgulas

Idiomas diferentes do inglês

  • Para artigos que não o inglês no idioma Inglês Wiki, coloque o código de linguagem entre parênteses no final do artigo.
  • EXEMPLO:
    • SQL Server (it-IT)
  • Também adicionar o código do idioma como uma tag (sem parênteses).
  • EXEMPLO:
    • Tags: it-IT
  • Isto é para a filtragem nas buscas, para torná-lo mais fácil de identificar que língua o artigo é escrito, e para torná-lo mais óbvio para saber o que pode precisar de artigos a serem migrados para uma nova instância de linguagem TechNet Wiki.
  • Para obter uma lista de todos os códigos de linguagem e de links para todos os artigos para cada idioma, consulte as Diretrizes de Língua Título não-inglês .
  • Não use "(pt-BR)" em títulos ingleses. É o wiki Inglês, e, eventualmente, cada idioma pode ter seu próprio wiki.
  • Note que você não precisa usar os códigos de linguagem para não-ingleses casos Wiki. Por exemplo, na versão Brasil (Português) do TechNet Wiki, você não precisa colocar o código "(pt-BR)" no título ou nas tags. Temos também versões russas e chinesas da Wiki.

 

↑  Voltar ao Topo


Font and Design

Apesar de todas estas diretrizes devem ser seguidas, as maiores prioridades são o tipo de fonte, tamanho da fonte, e para ficar com uma forma de cor preta ao longo do artigo. Essas três diretrizes são importantes porque elas impactam a coesão, branding, e consistência da aparência do TechNet Wiki.

Omissão

  • Por padrão, o editor usa:
    • Tipo de fonte: UI Segoe
    • Tamanho da fonte: tamanho da fonte 12 pontos
    • Cor da fonte: preto
  • Você não precisa codificar essas fontes padrão, tamanhos ou cores.

Orientações

  • Use preto ao longo do artigo, incluindo os cabeçalhos de seção.
  • Código
    • Use Courier New, 11px
  • Capitalização
    • Capitalizar as primeiras letras do nome de uma caixa de diálogo ou janela.
    • Capitalizar as primeiras letras do texto como ele aparece na interface do usuário (UI).
    • Use todas as tampas em NOTA e exemplo.
  • Itálico
    • Use itálico para citações de ênfase e de texto
  • Negrito
    • Use negrito em termos de interface do usuário só (texto que aparece na interface do produto).
    • EXEMPLO:

      • Clique arquivo .
    • Use negrito em nota.
    • EXEMPLO:
      • NOTA: Não formate seu disco rígido.
  • Sublinha
    • Não usar em cabeçalhos, exemplo, ou nota.
  • Notas
    • Use todos os tampões. Por exemplo:
      • NOTA:
    • Use uma vírgula após ele e não um traço.
    • Negrito-lo.
    • Se você tiver mais de uma nota, use " NOTAS: "e, em seguida, incluir uma lista com marcadores abaixo dela.
  • Imagens
    • Use imagens menores para que os usuários de telefones inteligentes podem vê-los.
    • Você pode fazer upload de uma imagem maior e, em seguida, redimensioná-la para um tamanho menor.
  • Tabelas

↑  Voltar ao Topo


Layout da Página

Páginas Stub

  • Stub páginas são páginas sem conteúdo útil adicionado ainda. Eles existem para lembrá-lo e com a comunidade, preencha o conteúdo.
  • Uma vez que o conteúdo útil é adicionada, remova a tag "esboço" da lista de etiquetas do artigo. 
  • Coloque este texto na parte superior da página: Este artigo é um esboço . Preencha o conteúdo ausente.
  • Após o texto toco no topo, você pode querer incluir uma lista com marcadores de possíveis tópicos, seções ou listas no tópico.
  • Adicionar a tag "stub" para o artigo. Recomendamos que você não incluir muitas outras marcas, porque é melhor se os artigos stub não são muito fáceis de encontrar (porque você quer contribuintes para encontrá-los com mais freqüência do que os leitores-only).
  • Quando o artigo tem algum conteúdo útil, remova o texto esboço ea marca topo. Se você sente o artigo ainda não está completo, use as "Necessidades trabalho" tag e incluir uma declaração de que o artigo precisa de mais trabalho.

Seções

  • Seção Introdução no topo
    • Este deve ser, no mínimo, uma frase, mas torná-lo não mais do que dois parágrafos curtos.
    • Se esta seção é muito longo, ele irá tornar mais difícil para o leitor a perceber a página TOC.
  • Seção TOC
  • <nome Do Wiki Páginas seção
    • Esta seção é opcional e deve ser utilizado em Geral artigos.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
    • Puxe-o em uma página do Portal, se> 10 links. Se você tem mais de 10 links nesta seção, crie uma nova página do Portal sobre o tema ("<Nome do Portal"), que inclui apenas links para outros artigos Wiki sobre o tema.
  • Veja também a seção
    • Link para domínio artigos pai e artigos relacionados no TechNet Wiki (como um artigo Visão geral ou um Portal que lista todos os artigos TechNet Wiki sobre essa tecnologia).
    • Esta seção deve existir em todos os artigos, se possível.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
    • Limitar esta seção para cerca de 10 ligações. Se você tem mais de 10 ligações que pertencem a este artigo, criar uma página separada portal que liga a Wiki-artigos que dizem respeito a um tema comum. 
  • Seção Recursos Adicionais
    • Estes são os links externos, incluindo links para Microsoft TechNet e sites que são não-Wiki.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
    • Puxe-o na parte inferior de uma página do Portal, se> 10 links.
  • Seção Recursos TechNet
    • Esta lista é específica para os recursos TechNet encontrados sobre o tema.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
    • Puxe-o em uma página Survival Guide, se> 10 links.
  • Seção TechNet Library
    • Esta lista é específica para páginas TechNet Biblioteca encontrados sobre o tema.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
    • Puxe-o em uma página Survival Guide, se> 10 links.
  • Seção créditos 
    • Você deve dar crédito ao autor original.
    • Verifique se você tem a permissão do autor para publicar seus trabalhos no TechNet Wiki.
    • Incluir uma seção intitulada "Créditos" na parte inferior.
    • Incluir uma linha antes das seções da lista na parte inferior.
    • Utilize este formato: Este artigo foi originalmente escrito por author> <original .
    • Use itálico em toda a linha.
    • Negrito os nomes ou vinculá-los ao perfil.
    • Você também pode vincular a página de origem do autor, como um blog ou tópico do fórum.
    • Se você reescreveu o artigo baseado em artigo de alguém, obter permissão e, em seguida, use este formato:

      Este artigo é baseado em informações de <article reference> escrito por author> <orginal .

  • Seção de Referências
    • Utilize esta seção se você puxou material de origem e idéias de outros sites, blogs ou fóruns. Verifique se você tem permissão de autores para usar seu material.
    • Esta é uma lista de ligação no fundo de um artigo.
    • Coloque uma regra de linha horizontal acima e abaixo desta seção.
  • Outro seção Idiomas
    • Se o artigo foi traduzido em pelo menos uma língua adicional, adicione uma seção "Outras Línguas" para o fundo do artigo Inglês, e adicione o "tem Outras Línguas" tag com o artigo apenas em Inglês (não adicionar a tag para artigos em outras línguas, que devem ter marcas semelhantes exclusivos para suas línguas).
    • Em uma lista com marcadores nesta seção, a lista de links para todos os outros artigos em diferentes idiomas.

 

Cabeçalhos

  • Use o estilo de parágrafo H1 para todos os seus títulos de seção de nível superior.
  • Em seguida, utilizar H2 para o próximo nível, e assim por diante.
  • Isso cria consistência entre os artigos e permite que o sistema de TOC para trabalhar melhor.

Geral

  • In-line ligações Wiki
    • Na seção de introdução, incluir um link (quando possível) com o tema principal.
    • Incluir um hiperlink no termo do texto.
    • Exemplo: "Expressões de Análise de Dados é uma nova linguagem usada em PowerPivot para Excel . "
  • Links externos em linha
    • Isto inclui todos os links Wiki não TechNet, incluindo links para todos os outros sites da Microsoft.
    • Não temos diretrizes, por causa de um novo recurso que adiciona uma bandeira para todos os links externos e abre o link em uma nova janela. Para 
  • Os espaços entre os parágrafos
    • Inclua um espaço em branco entre os parágrafos.
  • Regras linha horizontal
    • Use Regras linha horizontal para dividir cada seção H1.
    • Use Regras linha horizontal para dividir o Consulte também, links externos, Recursos Comunitários, referências, recursos TechNet e seções TechNet da Biblioteca.
    • Para colocar uma regra de linha horizontal, clique no botão Insert Rule no lado direito da barra de ferramentas.
  • 'Voltar ao Topo "ligações
    • Inclua o gráfico seta (você pode copiar e colá-lo a partir deste artigo).
    • Use o texto, "Voltar ao topo"
    • Ligar de volta até o topo do artigo (e não apenas o TOC).
    • Inclua essa na parte inferior de cada secção, de cima a regra de linha horizontal.
    • EXEMPLO: ↑  Voltar ao Topo
  • Diferentes estilos de página / templates
    • Visão geral artigos
    • Solução de problemas artigos
    • Artigos de instrução
    • Portais
    • Guias de Sobrevivência
    • Stubs
NOTA : Podemos querer adotar mais técnicas de formatação de este excelente artigo de Maria Lingel. ↑  Voltar ao Topo


Assinaturas de Crédito, e Personalização

Como Ana mencionado neste blog   , a Wikipedia tem a dizer sobre assinaturas: "Ao editar uma página, os principais artigos de namespace não deve ser assinado, pois o artigo é um trabalho compartilhado, com base nas contribuições de muitas pessoas, e um editor deveria não ser apontada acima dos outros. " - Wikipedia: Assinaturas A exceção que fazemos, é que nós permitimos a seção Créditos (consulte "Credits Seção" em "Layouts" acima).


  • Não use primeira pessoa
    • Utilize terceira pessoa em seu lugar.
    • Se você estiver colando em seu blog, onde você usa primeira pessoa, você ea comunidade deve alterá-lo para terceira pessoa em seu lugar.
    • EXEMPLO:
      • Este artigo informa como configurar seu computador.
    • Mau exemplo:
      • Agora eu estou indo mostrar-lhe como configurar seu computador.
  • Evite comentários pessoais
    • Remova qualquer comentário pessoal desnecessário que poderia ter sido no post do blog.
    • EXEMPLO:
      • Este artigo informa como configurar o PowerPivot para SharePoint.
    • Mau exemplo:
      • Então, eu estava tomando banho ontem à noite, e foi aí que me ocorreu (eu faço o meu melhor pensamento no chuveiro), que eu deveria mostrar-lhe como configurar o PowerPivot para SharePoint!
    • Podemos usar comentários pessoais em um blog em vez (incluindo Wiki Ninjas blog). Basta deixar um comentário aqui para fazer um pedido.
  • Vire personalização e opiniões em seções com listas
    • Por exemplo, se você está explicando por que você escreveu o artigo, em vez disso você pode transformá-lo em uma seção sobre os valores do artigo e, em seguida, incluí-los para fora.
    • Por exemplo, se você quiser dar a sua opinião pessoal sobre um tema que as pessoas discordam sobre, você pode fazer cortes em ambos os lados da discussão e listar as razões de ambos os lados.

No entanto, queremos dar-lhe crédito por seu trabalho ... Nós fornecemos cinco maneiras para você receber o crédito por suas contribuições em TechNet Wiki:

  1. Publicado pela primeira vez e última versão por informações e links de perfil
    • Esta é a seção na parte superior direita, que lhe diz que publicou e revisou o artigo
    • Ela inclui o seu nome
    • Seu avatar / foto
    • Seu papel de status (como a Microsoft, MCC, e MVP)
    • A data que você criou ou modificou o artigo
    • Link para o seu perfil
    • O recurso Hover Cartão onde o leitor pode passar o cursor do mouse sobre o seu nome e ver os seus pontos de reconhecimento, medalhas totais Façanha, e as três últimas medalhas de realização que você ganhou
  2. Lista AUTOR REVISÃO da guia Histórico e Comentários
    • Seu nome
    • Link para o seu perfil
    • Os comentários também incluir sua foto / avatar, e as características Hover Cartão
  3. A seção de Créditos
    • Você deve dar crédito ao autor original.
    • Verifique se você tem a permissão do autor para publicar seus trabalhos no TechNet Wiki.
    • Incluir uma seção intitulada "Créditos" na parte inferior.
    • Incluir uma linha antes das seções da lista na parte inferior.
    • Utilize este formato: Este artigo foi originalmente escrito por Jayant .
    • Use itálico em toda a linha.
    • Negrito os nomes ou vinculá-los ao perfil.
    • Você também pode vincular a página de origem do autor, como um blog ou tópico do fórum.
  4. Marcações
    • Você pode criar uma marca pessoal para o autor original ou principal contribuinte, para acompanhar todos os artigos que a pessoa escreveu.
    • EXEMPLO: O " Ed Preço tag "
  5. Comentários
    • A secção de comentários está na parte inferior da página (cada página tem uma secção de comentários no separador artigo, no fundo da página).
    • Deixe um comentário para responder a perguntas ou a incluir personalização, por exemplo, como a idéia artigo veio a você no chuveiro.  

↑  Voltar ao Topo 


Links e Acessibilidade

Siga estas orientações, a fim de fornecer uma história completa de navegação Wiki e acessibilidade. Poderíamos tentar automatizar mais desses recursos no futuro, a fim de exigir menos trabalho manual e manutenção. o tópico relacionado de Cross-Linking é discutido em Wiki: Cross-Linking NOTA: Esta seção inclui apenas breves explicações. Para obter orientações completas e detalhes, consulte as balas apropriadas no Layout da Página seção acima.



  • Artigo tabela de conteúdos
    • Esta é a seção "Neste artigo" sob a seção de introdução.
    • Veja Layout da página  acima para obter instruções detalhadas sobre como criar esta seção.
  • 'Voltar ao Topo "ligações
    • Estes links existem na parte inferior de cada seção (acima da linha horizontal) e ligar de volta até o topo do artigo (e não apenas o TOC).
  • Na linha de ligações
    • Na seção de introdução, incluir um link (quando possível) com o tema principal.
  • <nome Do Wiki Páginas seção
    • Puxe-o em uma página do Portal, se> 10 links.
  • Veja também a seção
    • Esta é uma lista de links na parte inferior, que liga a artigos pai de domínio (e artigos relacionados) no TechNet Wiki.
  • Seção Recursos da comunidade
    • Estes são os links externos, incluindo links para Microsoft TechNet e sites que são não-Wiki.
  • Seção de Referências
    • Utilize esta seção se você puxou material de origem e idéias de outros sites, blogs ou fóruns. Verifique se você tem permissão de autores para usar seu material.
  • Seção Recursos TechNet
    • Esta lista é específica para os recursos TechNet encontrados sobre o tema. 
  • Seção TechNet Library
    • Esta lista é específica para páginas TechNet Biblioteca encontrados sobre o tema.
  • Diretrizes do Portal
    • Se você tem 10 ou mais ligações para artigos TechNet Wiki, criar uma página de portal separado que é composta de apenas artigos TechNet Wiki.
    • Você pode incluir uma seção Recursos Comunitários se você tiver <10 links.
  • Diretrizes Guia de Sobrevivência
    • Se você tem 10 ou mais ligações para artigos não TechNet Wiki, criar uma página de recursos guia de sobrevivência / comunidade separada.
    • Use o "Guia de Sobrevivência", como o nome em vez de "Todos os Recursos", "Recursos da comunidade" ou "Recursos". 
      • Por exemplo, use "Guia de Sobrevivência do PowerPivot" em vez de "Recursos do PowerPivot".

↑  Voltar ao Topo   


Marcações

Para fazer um artigo mais fácil de descobrir usando a busca do wiki, incluir tags que são relevantes para o tema discutido em seu artigo. Por exemplo, um artigo que discute o uso do SQL Server Express com o PHP deve ser marcado com o 'SQL', 'SQL Express' e tags 'php'.

  • Vírgulas

    • Divida cada tag com uma vírgula e um espaço. Por exemplo, "SQL, SQL Express, PHP, necessidades trabalho"
  • Invólucro
    • Quando possível, use caixa título, como "problemas Guias".
    • Sempre utilize caixa adequada sobre nomes de produtos, tais como "SharePoint 2010".
    • EXEMPLO:
      • PowerPivot
    • Mau exemplo:
      • powerpivot
    • Note que nós sabemos que muitas marcas têm sido "arruinada" no sentido de que a primeira pessoa entrou na caixa de forma incorreta e agora estamos presos a ele. Temos um pedido de recurso para atualizar tag caixa.
  • Seja conciso
    • Tente limitar as tags para um, dois, ou três palavras. 
  • Espaçamento
    • Use um espaço entre as palavras, em vez de colocá-los juntos. Por exemplo, use "Necessidades trabalho" em vez de "needswork".
    • Porque você dividir as etiquetas por vírgulas, você não precisa usar aspas em torno de várias palavras.
  • Tags específicas
    • Apagar - Use esta tag quando você acha que um artigo deve ser suprimida. Então, entre em contato com os administradores de Wiki para discussão.
    • Necessidades Trabalho - Use essa marca quando o seu artigo inclui algumas informações (por isso não é um esboço), mas não o suficiente para ser um artigo útil.
    • Stub - Use somente esta tag (e não outras marcas) quando nenhum conteúdo útil existe.
    • Wiki - Use esta tag quando o artigo é sobre TechNet Wiki.
  • Language tags
    • Adicione o código de linguagem como um tag (sem parênteses).
    • EXEMPLO:
      • Tags: it-IT
    • Para obter uma lista de todos os códigos de linguagem e de links para todos os artigos para cada idioma, consulte as Diretrizes de Língua Título não-inglês .
    • Note que você não precisa adicionar códigos de idioma para as etiquetas quando o artigo está em um Wiki dedicado a esse idioma. Por exemplo, você não precisa adicionar a tag "ru-RU" para artigos na instância russa do TechNet Wiki.
    • No entanto, est��o adicionando a tag "en-US" a todos os artigos em inglês. Isso nos permite filtrar rapidamente para fora todos os artigos não-Inglês são resultados de tag.

↑  Voltar ao Topo


Diferentes Estilos de página

Esta seção requer mais informações.

  • Visão geral artigos
  • Solução de problemas artigos
  • Artigos de instrução
  • Portais
  • Guias de Sobrevivência
  • Artigos Stub

↑  Voltar ao Topo


Consulte também


Outras linguagens