[Request]: Will v2 docs be re-written before release?

Aberta
#1,650 1 comentário 1 reação 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Esta issue ainda não foi avaliada.

Descrição

Hi there, I just read through the docs for Solid v1. It was very well written, easy to understand, and it got me really excited about adopting Solid! I know the v2 release is on the horizon so I poked around the v2 docs a bit and I'm a bit disheartened by the current state of it.

The new content appears to be mostly AI-generated and contains a lot of claude babble and weird choppy sentences. I found it to be significantly more verbose and confusing than the existing docs. I linked the react migration guide as an example of what I'm talking about. My understanding is that v2 is supposed to remove complexity from the framework, but the new docs give the opposite impression.

Is the plan for a human to rewrite the documentation prior to an official release? To be honest, I'm a bit turned off to the project if this is indicative of where things are headed.

Linguagem predominante
MDX
Estrelas
290
Forks
366
Merge médio
1d 5h
PRs com merge (30d)
25

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de solidjs/solid-docs

Todas as issues de solidjs/solid-docs

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.