Guia de Criação de Tópicos

Comunidade
1

Aqui você encontra dicas e convenções de formatação para os tópicos dessa comunidade.

Formatação

A linguagem usada na formatação dos tópicos é majoritariamente Markdown. Clique aqui para ter visão geral sobre este tipo de formatação.

Títulos / Heading

Os títulos de um tópicos são organizados por níveis, que iniciam a partir de h1 e seguem com h2, h3 e assim por diante.

A seguir alguns cuidados que devem ser tomados ao utilizar os títulos:

  • O título h1 é reservado ao título do tópico, portanto, inicie a marcação dos títulos sempre a partir de h2.

  • Além disso, procure usar a hierarquia correta dos títulos. Por exemplo, evite usar um h3 antes de um h2.

  • Use títulos curtos. Evite usar textos que na verdade deveriam fazer parte da explicação, e não do título.

Para criar um título em um tópico, basta inserir # no início da linha.

Item h2

## Item h2

Item h3

### Item h3

Item h4

#### Item h4

Nota: h = heading

Detalhes importantes sobre a utilização dos títulos:

  • O título h1 é reservado ao título do tópico, por tanto, inicie a marcação dos títulos sempre a partir do h2.
  • Os títulos devem ser hierárquicos. Por exemplo, evite usar um h3 antes de um h2.

Código de Programação

Sempre que for inserir um código de programação ou conteúdo de log, use a formatação de código.

Formatação em linha

Basta inserir o código entre crases (`).

Por exemplo:

Use o comando SELECT para selecionar os registros.

Use o comando `SELECT` para selecionar os registros.

Formatação em bloco

A formatação em bloco deve ser usada sempre que o código possuir mais de uma linha.

Por exemplo:

SELECT *
FROM tabela
WHERE id = 1

```
SELECT *
FROM tabela
WHERE id = 1
```

As cores usadas da formatação são identificadas automaticamente, mas o ideal é especificar a linguagem para que o sistema faça a formatação correta. A linguagem pode ser passada logo após os 3 primeiros crases, dessa forma:

```sql

Segue a relação das siglas para formatação de cada linguagem:

Sigla Linguagem
sql SQL
js JavaScript
css CSS
html HTML
cs C#
text Texto sem formatação

Arquivos / Anexos

Arquivos de imagens podem ser adicionados às postagens, mas use este recurso com moderação.

  • Sempre que possível, tente se expressar através do texto.

  • Evite anexar Screenshots de código fonte. Use a formatação de Código de Programação apresentada no item acima para isso.

2 curtidas