Skip to content

docs(docs):preencher páginas de introdução com dados da comunidade #368

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ewbenigno wants to merge 1 commit into
base: 4.x
Choose a base branch
from
Open

docs(docs):preencher páginas de introdução com dados da comunidade #368

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 7 additions & 10 deletions docs/introduction/como-participar.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Como participar
order: 5
---

> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).


# Como participar

Expand All @@ -15,12 +15,12 @@ passos para fazer parte da comunidade e começar a aprender e construir junto.

O Discord é o ponto de encontro da comunidade. É lá que acontecem as conversas
do dia a dia, os avisos e as reuniões.
[a confirmar: link oficial de convite do servidor no Discord.]
(https://discord.gg/he4rt)

Comment on lines +18 to 19

@coderabbitai coderabbitai Bot Jun 30, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Discord URL is not a clickable Markdown link.

The URL (https://discord.gg/he4rt) renders as literal text. Use [text](url) or bare <url> syntax.

- (https://discord.gg/he4rt)
+ <https://discord.gg/he4rt>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
(https://discord.gg/he4rt)
<https://discord.gg/he4rt>
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/introduction/como-participar.md` around lines 18 - 19, The Discord
reference is currently written as plain parenthesized text instead of a
clickable Markdown link. Update the link in the participation section of
como-participar.md to use proper Markdown link syntax or angle-bracket URL
syntax, and make sure the Discord invite text renders as an actual clickable
link.

## 2. Se apresente

Depois de entrar, passe pelo canal de boas-vindas
**[a confirmar: nome do canal]** e conte um pouco sobre você: o que faz, o que
Depois de entrar, passe pelo canal de boas-vindas:
**apresentações** e conte um pouco sobre você: o que faz, o que
está estudando e o que te trouxe até aqui. A comunidade adora conhecer gente
nova.

Expand All @@ -34,7 +34,7 @@ conhecer pessoas e entrar no ritmo da comunidade. Veja os detalhes na página

A He4rt mantém projetos open source feitos pela comunidade. Você pode contribuir
com código, documentação, ideias ou ajudando outras pessoas.
[a confirmar: link para os repositórios / organização no GitHub.]
(https://github.com/orgs/he4rt/repositories)

@coderabbitai coderabbitai Bot Jun 30, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

GitHub URL is not a clickable Markdown link.

Same issue: (https://github.com/orgs/he4rt/repositories) renders as literal text.

- (https://github.com/orgs/he4rt/repositories)
+ <https://github.com/orgs/he4rt/repositories>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
(https://github.com/orgs/he4rt/repositories)
<https://github.com/orgs/he4rt/repositories>
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/introduction/como-participar.md` at line 37, The GitHub URL in the
participation doc is plain text instead of a clickable Markdown link; update the
reference in the introduction content so it uses proper Markdown link syntax,
and verify the surrounding text in the same section renders as an actual
clickable link rather than a literal parenthesized URL.


## 5. Conecte sua conta na plataforma

Expand All @@ -45,8 +45,5 @@ pontos e desbloquear conquistas.
## Precisa de ajuda?

Se ficar com qualquer dúvida, pergunte nos canais da comunidade — sempre tem
alguém disposto a ajudar.
[a confirmar: canal de suporte / dúvidas.]

> Os links e nomes de canais acima são placeholders. Confirme cada um com a
> comunidade antes de publicar esta página.
alguém disposto a ajudar.
Canal de suporte / dúvidas: **fórum-de-ajuda**.
25 changes: 12 additions & 13 deletions docs/introduction/marcos-e-conquistas.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Marcos e conquistas
order: 2
---

> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).


# Marcos e conquistas

Expand All @@ -16,33 +16,32 @@ projetos que hoje conectam centenas de pessoas desenvolvedoras pelo Brasil.

A He4rt nasceu da vontade de criar um espaço acolhedor onde quem está começando
e quem já tem experiência pudessem aprender em conjunto, sem barreiras. O que
começou como um grupo pequeno [a confirmar: ano de fundação] foi ganhando vida a
começou como um grupo pequeno 2018 foi ganhando vida a
cada conversa, live e projeto compartilhado.

Comment on lines +19 to 21

@coderabbitai coderabbitai Bot Jun 30, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Missing preposition before year.

"começou como um grupo pequeno 2018" → add "em" or rephrase to "no início de 2018".

- começou como um grupo pequeno 2018 foi ganhando vida a
+ começou como um grupo pequeno em 2018 e foi ganhando vida à
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/introduction/marcos-e-conquistas.md` around lines 19 - 21, The
introductory sentence is missing a preposition before the year, so update the
text in the markdown content to read naturally by inserting “em” before 2018 or
rephrasing it to “no início de 2018”; locate the affected sentence in the
introductory paragraph and adjust the wording accordingly.

## Linha do tempo

> Os marcos abaixo são exemplos a serem validados com quem viveu cada um deles.

- **[a confirmar: ano]** — Primeiros encontros e formação do núcleo da

- 2018 — Primeiros encontros e formação do núcleo da
comunidade.
- **[a confirmar: ano]** — Lançamento do servidor no Discord como ponto central
- 2018 — Lançamento do servidor no Discord como ponto central
de convivência.
- **[a confirmar: ano]** — Início das reuniões semanais abertas a toda a
- 2018 — Início das reuniões semanais abertas a toda a
comunidade.
- **[a confirmar: ano]** — Primeiros projetos open source mantidos pela
- 2020 — Primeiros projetos open source mantidos pela
comunidade.
- **[a confirmar: ano]** — Construção da plataforma he4rtdevs.com e do sistema de
- 2020 — Construção da plataforma he4rtdevs.com e do sistema de
gamificação.

## Em números

> Todos os números abaixo são placeholders e precisam ser confirmados com dados
> reais antes da publicação.

- **[a confirmar]** pessoas na comunidade.

- 25.040 pessoas na comunidade.
- **[a confirmar]** reuniões semanais realizadas.
- **[a confirmar]** projetos open source publicados.
- **[a confirmar]** contribuidores ativos na plataforma.
- 39 projetos open source publicados.
- 21 contribuidores ativos na plataforma.

## O que vem por aí

Expand Down
11 changes: 3 additions & 8 deletions docs/introduction/nossos-valores.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,11 @@ title: Nossos valores
order: 4
---

> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).


# Nossos valores

Mais do que código, a He4rt Developers é feita de pessoas. Os valores abaixo são
uma proposta de como enxergamos a convivência na comunidade — e precisam ser
revisados e aprovados por quem faz a He4rt acontecer.
Mais do que código, a He4rt Developers é feita de pessoas. Os valores abaixo guiam como vivemos a convivência na comunidade.

## Acolhimento

Expand All @@ -32,13 +30,10 @@ aberta, o open source e o crédito a quem contribui.

A He4rt é um espaço para todas as pessoas. Não há lugar para preconceito,
assédio ou qualquer forma de discriminação.
[a confirmar: link para o Código de Conduta oficial da comunidade.]
(https://github.com/he4rt/docs/blob/main/subpage/code-of-conduct.md)

@coderabbitai coderabbitai Bot Jun 30, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Code of Conduct URL is not a clickable Markdown link and breaks paragraph flow.

The parenthesized URL renders as literal text and sits on its own line. Integrate it into the preceding sentence as a proper link.

  A He4rt é um espaço para todas as pessoas. Não há lugar para preconceito,
- assédio ou qualquer forma de discriminação.
- (https://github.com/he4rt/docs/blob/main/subpage/code-of-conduct.md)
+ assédio ou qualquer forma de discriminação. Leia nosso [Código de Conduta](https://github.com/he4rt/docs/blob/main/subpage/code-of-conduct.md).
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/introduction/nossos-valores.md` at line 33, The Code of Conduct
reference is currently written as a bare parenthesized URL, which breaks the
paragraph flow and won’t render as a proper clickable link. Update the sentence
in the markdown so the existing reference is integrated inline as a Markdown
link, keeping the surrounding text in the same paragraph and preserving the
intended wording.


## Transparência

Decisões importantes são discutidas abertamente com a comunidade. Esta própria
documentação é um exemplo: tudo aqui pode ser revisado e melhorado.

> Estes valores são um rascunho inicial. A redação final deve sair de uma
> conversa com a comunidade — possivelmente referenciando um Código de Conduta
> formal [a confirmar].
18 changes: 7 additions & 11 deletions docs/introduction/reunioes-semanais.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Reuniões semanais
order: 3
---

> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).


# Reuniões semanais

Expand All @@ -14,21 +14,20 @@ aprendizados, mostrar projetos e simplesmente estar junto.

## Quando acontecem

As reuniões acontecem toda semana, **[a confirmar: dia da semana]** às
**[a confirmar: horário, fuso de Brasília]**. O encontro é aberto a qualquer
As reuniões acontecem toda semana, segunda-feira às
22h, horário de Brasília. O encontro é aberto a qualquer
pessoa da comunidade — não importa se você é iniciante ou já trabalha na área há
anos.

## Onde acontecem

Os encontros são realizados no **[a confirmar: canal de voz do Discord / outra
plataforma]**. O link e os lembretes são divulgados nos canais da comunidade
Os encontros são realizados no canal de voz **apresentações** do servidor
no Discord. O link e os lembretes são divulgados nos canais da comunidade
antes de cada reunião.

## Como costuma ser

> O formato abaixo é uma descrição plausível a ser validada com quem organiza os
> encontros.


- **Boas-vindas e novidades** — atualizações da comunidade e recados.
- **Tema da semana** — alguém apresenta um assunto, projeto ou aprendizado.
Expand All @@ -39,7 +38,4 @@ antes de cada reunião.

Não é preciso se inscrever nem preparar nada. Basta entrar no canal no horário
combinado, ligar (ou não) o microfone e participar no seu ritmo. Quem preferir
só ouvir também é muito bem-vindo.

> Se você organiza ou participa das reuniões, ajude a confirmar dia, horário,
> plataforma e formato para que esta página reflita a realidade da comunidade.
só ouvir também é muito bem-vindo.