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

Aperta
#1,650 1 commento 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

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.

Lingua principale
MDX
Stelle
290
Fork
366
Merge medio
1g 5h
PR unite (30g)
25

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di solidjs/solid-docs

Tutte le issue di solidjs/solid-docs

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.