Skip to content
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.

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

Revisão e conversão do wiki #702

Open
5 of 9 tasks
alfsb opened this issue Oct 30, 2024 · 2 comments
Open
5 of 9 tasks

Revisão e conversão do wiki #702

alfsb opened this issue Oct 30, 2024 · 2 comments

Comments

@alfsb
Copy link
Member

alfsb commented Oct 30, 2024

Da discussão recente no tópico de Coordenação, sobre renovar e converter o wiki, eu parei para dar uma boa olhada no wiki atual, e disso tive duas impressões:

  1. Há um tanto de coisas a revisar sim (tem coisas antigas como editores de texto que nem exitem mais);
  2. Fiquei na dúvida se partimos mesmo para conversão, ou deixa como está.

O maior problema de sair do wiki para markdown é que perde-se a interface wiki, que é menos poluída que o normal GitHub. É mais focada no texto. Se souberem de alguma forma e fazer uma pasta com markdown ser exibida de maneira mais limpa na interface GitHub ou de terceiros, isso resolveria.

Outra questão é onde colocar o markdown. Eu imagino que criar um .docs/guia-resumido/ resolva, já que o revcheck novo ignora dotflies, e ter um guia-resumido abre espaço daí para ter um guia-completo, que fosse a tradução do dochowto.


Estas questões continuam em aberto, mas eu puxei para mim de atualizar o wiki. Progresso:

  • Home
  • Editores de texto
  • Guia de edição do manual // 60% completo
  • Issues e perguntas frequentes
  • Prioridades
  • Roteiro git
  • Roteiro web
  • Tag de revisão
  • Teste de pull requests
@alfsb
Copy link
Member Author

alfsb commented Nov 13, 2024

Puxando para mim a atualização do wiki.

Por enquanto hospedando os textos no próprio wiki até uma indicação de funcionalidade, que permita exibir documentos markdown hospedados no GitHub em uma interface mais limpa..

@alfsb
Copy link
Member Author

alfsb commented Nov 21, 2024

Fazendo as atualizações aos poucos. Todo dia eu tento fazer um pouco, as o Roteiro git está se mostrando bem longo e trabalhoso, como esperado. Além disso, eu estou também, quase diariamente, mexendo no doc-base trabalhando em um projeto de conseguir separar o language-snippets.ent arquivos individuais.

Só que nesse meio tempo choveu alterações por conta do PHP 8.4. É a primeira vez que os tradutores atuais podem estar vendo isso, e meio que é assim mesmo, é um monte de alterações diárias. Caso precisem de ajuda ou estejam empacados em alguma coisa das atualizações, deem um toque, que eu dou uma parada nessas outras frentes para ajudar.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant