Dataframe expression explanations sould be more prominent

Đang mở
#1,084 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Tài liệu
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với tab „documentation commands“ và ba trang dfr: dataframe, dataframe or lazy dataframe và expression. So sánh cách các biểu thức dataframe, hành vi của lazy so với eager và các lệnh như group-by, dfr col và dfr as datetime được trình bày. Hoàn thành nghĩa là tài liệu liên quan dễ tìm hơn và những điểm khác biệt này được giải thích rõ ràng.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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!

Ngôn ngữ chính
TypeScript
Star
258
Fork
561
Merge trung bình
3 giờ 20 phút
Pull request đã merge (30 ngày)
15

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nushell/nushell.github.io

Tất cả issue của nushell/nushell.github.io

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.