[guides] Updating VisiData Documentation

[anjakefala]

Help us write guides! If someone has committed to working on a guide, they are tagged next to the guide. Checked guides have been written.

If you want to help out, please comment which guide you would like to write.

Guide to writing guides

• [ ] GuideIndex: A Guide to VisiData Guides (you are here)
• [ ] HelpGuide: Where to Start and How to Quit
• [x] MenuGuide: The VisiData Menu System (@anjakefala)
• [X] CommandsSheet: How to find the command you want to run (@thejud)

Barebones Basics

• [ ] MovementGuide: Movement and search
• [ ] InputGuide: Input keystrokes
• [ ] SortGuide: Sorting
• [x] ColumnsGuide: Rename, hide, and resize columns (@thejud)
• [x] TypesSheet: Column types (@reagle)

Let's Rev VisiData Up

• [X] SelectionGuide: Selecting and filtering (@anjakefala)
• [ ] ColumnsSheet: Columns: the only way to fly
• [ ] StatusesSheet: Revisit old status messages
• [ ] SidebarSheet: Dive into the sidebar
• [ ] SaversGuide: Saving Data
• [X] ErrrorsSheet: What was that error? (@anjakefala)
• [X] ModifyGuide: Adding, Editing, Deleting Rows (@thejud)

The Varieties of Data Experience

• [x] SlideGuide: Sliding rows and columns around (@thejud)
• [ ] ExprGuide: Compute Python over every row
• [ ] JoinGuide: Joining multiple sheets together
  • [ ] vd.help_join: Quick reference help sidebar available during Join command #1961
• [ ] DescribeSheet: Basic Statistics (min/max/mode/median/mean)
• [ ] AggregatorsSheet: Aggregations like sum, mean, and distinct
• [X] FrequencyTable: Frequency Tables are how you GROUP BY (@thejud)
• [X] PivotGuide: Pivot Tables are just Frequency Tables with more columns (@thejud)
• [x] MeltGuide: Melt is just Unpivot (@thejud)
• [X] JsonSheet: Some special features for JSON (@ajkerrigan)
• [ ] RegexGuide: Matching and Transforming Strings with Regex
• [ ] GraphSheet: Basic scatterplots and other graphs
• [ ] WindowFunctionGuide: Perform operations on groups of rows

For the Frequent User

• [ ] OptionsSheet: Options and Settings
• [x] ClipboardGuide: Copy and Paste Data via the Clipboard (@thejud)
• [x] DirSheet: Browsing the local filesystem (@anjakefala)
• [ ] FormatsSheet: What can you open with VisiData?
• [X] SplitpaneGuide: Split VisiData into two panes (@thejud)
• [ ] ThemesSheet: Change Interface Theme
• [ ] ColorSheet: See available colors
• [X] MacrosSheet: Recording macros (@anjakefala)
• [X] MemorySheet: Making note of certain values (@thejud)

Specific Use Cases

• [X] XsvGuide: CSV/TSV and other text-delimited formats (@saulpw)

Advanced Usage and Developers

• [ ] ThreadsSheet: Threads past and present
• [ ] DeveloperGuide: Inspecting internal Python objects

Appendices

• [ ] InputEditorGuide: Using the builtin line editor

[reagle]

I am working on TypesSheet: Column types.

[thejud]

I am working on the ColumnsGuide: Rename, Hide and Resize Columns

[thejud]

I'm also working on the SlideGuide

[thejud]

I have a couple more in progress, including MemorySheet, SplitPaneGuide and FrequencyTable. I've found that writing notes helps me explore and understand the functionality, and it's not too much more work to turn those notes into a guide :) Would you prefer separate MRs for each one, or a larger MR with multiple guides?

[anjakefala]

@thejud I would love seperate PRs for each one! =)

[thejud]

also will add a MeltGuide once we decide on the fate of tables in the guides :)