nushell / nushell/nushell.github.io

Dataframe expression explanations sould be more prominent

Aperta
#1,084 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

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:

  1. In the documentation commands tab, there is a section labeled expression. 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 as group-by was missing, while it's actually in the expression section.
  2. 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 col in a lazy expression, but dfr as datetime can't be at all was extremely confusing to me.
  3. 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

  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.

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

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.