Slackjeff Wiki

Juntando bits aprendemos juntos

Ferramentas do usuário

Ferramentas do site


admin:wiki:convencoes

Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anteriorRevisão anterior
Próxima revisão
Revisão anterior
admin:wiki:convencoes [2025/08/14 00:33] – [Tópicos principais] forum desativado, direcionado para irc hrcerqadmin:wiki:convencoes [2025/08/14 01:01] (atual) – [Caixas de código] largura das caixas de código hrcerq
Linha 169: Linha 169:
  
 Essa opção funciona em ambas as marcações, porém aqui não a utilizamos para a marcação ''<code>''. Para ''<file>'' utilizamos apenas nos casos em que o arquivo inteiro é apresentado. Para caixas de código que mostram apenas um trecho de um arquivo maior, não se deve usar essa aba superior. Essa opção funciona em ambas as marcações, porém aqui não a utilizamos para a marcação ''<code>''. Para ''<file>'' utilizamos apenas nos casos em que o arquivo inteiro é apresentado. Para caixas de código que mostram apenas um trecho de um arquivo maior, não se deve usar essa aba superior.
 +
 +=== Tamanho do texto ===
 +
 +Recomenda-se, sempre que possível, manter o texto das caixas em um limite de 80 caracteres, limite tipicamente aceito para terminais, e que ao mesmo tempo cabe confortavelmente nas caixas de código, sem necessidade de uma barra de rolagem horizontal (que além de esteticamente desagradável prejudica um pouco a navegação pela página).
  
 ==== Tabelas ==== ==== Tabelas ====
Linha 196: Linha 200:
 A [[:start|página inicial]] da Wiki possui uma lista de tópicos principais. Essa lista não deve ser alterada sem uma discussão prévia, por serem tópicos mais genéricos, elaborados a partir de páginas que já existiam, capturando a essência dos assuntos. A [[:start|página inicial]] da Wiki possui uma lista de tópicos principais. Essa lista não deve ser alterada sem uma discussão prévia, por serem tópicos mais genéricos, elaborados a partir de páginas que já existiam, capturando a essência dos assuntos.
  
-Caso se perceba que um novo tópico principal é realmente necessário, ou seja, que os já existentes não cobrem algum assunto de interesse para a Wiki, então uma nova discussão deverá ser iniciada <del>[[https://forum.slackjeff.com.br/viewforum.php?f=26|no fórum]] (desativado)</del> no canal **#wiki** do IRC.+Caso se perceba que um novo tópico principal é realmente necessário, ou seja, que os já existentes não cobrem algum assunto de interesse para a Wiki, então uma nova discussão deverá ser iniciada no canal ''#wiki'' do [[admin:irc:start|IRC]].
  
 Cada um dos tópicos principais possui sua própria página inicial, a qual deve iniciar por uma explicação resumida do que aquele tópico abrange. Os títulos dessas páginas devem ser o nome por extenso do tópico (por exemplo, "Utilitários"), que deve ser seguido por uma linha destacando o nome de contexto daquele tópico (para mais informações, vide a seção de [[#convencoes_de_contexto|convenções de contexto]], mais adiante). Cada um dos tópicos principais possui sua própria página inicial, a qual deve iniciar por uma explicação resumida do que aquele tópico abrange. Os títulos dessas páginas devem ser o nome por extenso do tópico (por exemplo, "Utilitários"), que deve ser seguido por uma linha destacando o nome de contexto daquele tópico (para mais informações, vide a seção de [[#convencoes_de_contexto|convenções de contexto]], mais adiante).
admin/wiki/convencoes.1755131580.txt.gz · Última modificação: por hrcerq