nushell / nushell/nushell.github.io
Dataframe expression explanations sould be more prominent
Nessuno ha ancora preso questa issue.
- Lingua principale
- TypeScript
- Stelle
- 258
- Fork
- 561
- Merge medio
- 3h 20m
- PR unite (30g)
- 15
Descrizione
Currently I find the documentation around dataframes and dataframe expressions to be very unclear/difficult to navigate. Some examples:
- In the documentation
commandstab, there is a section labeledexpression. This is about dataframe expressions specifically, and lazy data frames at that from as far as I can tell. I expected this tab to be about nu expressions specifically. This also meant that I thought a lot of documentation around dataframes such asgroup-bywas missing, while it's actually in theexpressionsection. - The difference between lazy and eager dataframes is exlained but the implications of this are mentioned only off hand. For example, the fact that you can only use
dfr colin a lazy expression, butdfr as datetimecan't be at all was extremely confusing to me. - Having three seperate pages for
dfrcommands (dataframe, dataframe or lazy dataframe and expression) makes it much harder to find things and is also bad for discoverability. I for example, just thought a bunch of standard things in dataframes were not implemented because of this.
These are the issues that come to mind, I hope this will be read as constructive, as that's how I mean it, not just to criticise. These were just a few issues that caused me a lot of confusion when trying to understand them. Thanks for all the hard work!
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia dalla scheda „documentation commands“ e dalle tre pagine dfr: dataframe, dataframe or lazy dataframe ed expression. Confronta come vengono presentate le espressioni dataframe, il comportamento di lazy rispetto a eager e comandi come group-by, dfr col e dfr as datetime. Il lavoro è completato quando il materiale rilevante è più facile da trovare e queste distinzioni sono spiegate chiaramente.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Ferma
- Chiarezza
- Da chiarire
- Idoneità per principianti
- 35/100