Há duas maneiras de criar links para artigos de suporte da Mozilla. Which method you use depends on where you are linking from. Se é do chrome do Firefox ou o Firefox para Android, você vai querer usar o método "in-produto". Se você estiver linkando de uma propriedade da web, então a URL menos a seqüência de localidade é o caminho a percorrer.
Índice
Criar links in-product para o SUMO
Metas para botões ou links dentro do chrome navegador deve seguir esse padrão:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
Exemplos:
- https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
- https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/36eol
A última parte da URL, o topico, pode ser qualquer string.
Firefox para Android deve usar /1/mobile
para distinguir o produto.
A tupla (produto, versão, os, local, tema) determina onde o usuário realmente vai. Isso permite que a equipe SUMO para mudar o destino do botão Ajuda, sem quebrar links / botões no Firefox. Temos metas específicas para todos os valores de tópicos e, por vezes, pode se separaram usuários de OS X ou o Windows para os artigos mais relevantes, ou aqueles com / versões específicas antigas do Firefox, etc.
Link para o SUMO de uma propriedade da web
Se esse conteúdo está sendo servido através da web e não acompanha o navegador, você não precisa (e não deve) usar os links in-product
Tudo que você tem a fazer é usar a URL sem o string locale. O SUMO irá enviar automaticamente o usuário para a versão do artigo em sua língua.
Assim, por exemplo, a fim de criar um link para o artigo Atualize o Firefox:
Use
- https://support.mozilla.org/kb/update-firefox-latest-version
Don't use
- https://support.mozilla.org/en-US/kb/update-firefox-latest-version
Vinculação de algum outro lugar
Se você não está linkando do Firefox ou um site (talvez um aplicativo, produto, email, etc), você provavelmente vai querer usar a URL (sem o locale) e identificar a fonte.
Exemplo:
- https://support.mozilla.org/kb/update-firefox-latest-version?utm_source=nameofsource
Questions?
Se você tiver dúvidas ou precisar de configurar o destino final do link no produto, entre em contato com Michael Verdi - mverdi at mozilla.com ou verdi no IRC.