nushell/docs/commands
Leonhard Kipp 48f535f02e
Display aliases and custom commands in which; fix #2810 (#2834)
* Display aliases and custom commands in which; Fix #2810

Example output of nu after the commit is applied:

```shell
/home/leo/repos/nushell(feature/which_inspect_alias)> def docker-ps [] { docker ps --format '{{json .}}' | from json -o }
/home/leo/repos/nushell(feature/which_inspect_alias)> which docker-ps
───┬───────────┬────────────────────────┬─────────
 # │    arg    │          path          │ builtin
───┼───────────┼────────────────────────┼─────────
 0 │ docker-ps │ nushell custom command │ No
───┴───────────┴────────────────────────┴─────────
/home/leo/repos/nushell(feature/which_inspect_alias)> alias d = gid pd
/home/leo/repos/nushell(feature/which_inspect_alias)> which d
───┬─────┬───────────────┬─────────
 # │ arg │     path      │ builtin
───┼─────┼───────────────┼─────────
 0 │ d   │ nushell alias │ No
───┴─────┴───────────────┴─────────
```

* Update documentation
2021-01-02 06:40:44 +13:00
..
alias.md docs/alias: simplify the 'persistent' section, using --save (#2285) 2020-08-01 08:11:26 -04:00
append.md Allow appending table literals. (#2693) 2020-10-22 03:26:30 -05:00
autoview.md Docs autoview pwd touch (#2068) 2020-06-28 14:22:26 +12:00
cal.md Fix cal command week-start example (#2040) 2020-06-24 17:15:19 +12:00
cd.md Add documentation for cd - 2019-10-08 18:32:42 +11:00
compact.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
config.md update config documentation (#2178) 2020-07-23 09:42:04 +12:00
count.md Add column flag to count command 2020-08-15 07:52:59 -05:00
date.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
debug.md Size command: rename max length to bytes (#2473) 2020-09-01 14:51:35 +12:00
default.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
du.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
echo.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
empty.md empty? rewrite. (#2641) 2020-10-06 05:21:20 -05:00
enter.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
every.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
exit.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
fetch.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
first.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
format.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-csv.md Update documentation to properly refer to subcommands with spaces (#2164) 2020-07-13 18:39:36 +12:00
from-ics.md docs/commands: add from.md, update subcommands (#1712) 2020-05-05 09:01:31 +12:00
from-ini.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-json.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-ods.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-toml.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-tsv.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-url.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-vcf.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-xlsx.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from-xml.md docs/commands: add from.md, update subcommands (#1712) 2020-05-05 09:01:31 +12:00
from-yaml.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
from.md Update documentation to properly refer to subcommands with spaces (#2164) 2020-07-13 18:39:36 +12:00
get.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
group-by.md Update documentation to properly refer to subcommands with spaces (#2164) 2020-07-13 18:39:36 +12:00
headers.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
help.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
histogram.md Bar Chart baseline. (#2621) 2020-09-30 13:27:52 -05:00
history.md Change f/full flag to l/long for ls and ps commands (#2283) 2020-08-02 06:30:45 +12:00
inc.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
insert.md Fix whitespace and typos (#1481) 2020-03-14 06:23:41 +13:00
last.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
lines.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
math-eval.md Make all bullet point items uppercase (#2257) 2020-07-26 06:15:12 +12:00
math.md Added math abs command. (#2789) 2020-12-16 05:37:12 +13:00
nth.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
open.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
pivot.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
prepend.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
ps.md Add cpu time to ps -l (#2507) 2020-09-07 17:02:45 +12:00
pwd.md Docs autoview pwd touch (#2068) 2020-06-28 14:22:26 +12:00
random.md Add random chars cmd (#2782) 2020-12-09 06:43:46 +13:00
README.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
reject.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
rename.md Split split command to sub commands. 2020-05-24 02:02:44 -05:00
reverse.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
save.md Update documentation to properly refer to subcommands with spaces (#2164) 2020-07-13 18:39:36 +12:00
select.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
shells.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
shuffle.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
size.md Size command: rename max length to bytes (#2473) 2020-09-01 14:51:35 +12:00
skip-while.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
skip.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
sleep.md Sleep command (#2381) 2020-08-22 05:51:29 +12:00
sort-by.md Add flag for case-insensitive sort-by (#2225) 2020-07-21 05:31:58 +12:00
split-column.md Auto-Generate Documentation for nushell.com (#2139) 2020-07-18 10:22:43 +12:00
split-row.md Auto-Generate Documentation for nushell.com (#2139) 2020-07-18 10:22:43 +12:00
start.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
str.md Add str reverse subcommand (#2170) 2020-07-15 08:47:04 +12:00
sys.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
tags.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
textview_config.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
to-csv.md Update documentation to properly refer to subcommands with spaces (#2164) 2020-07-13 18:39:36 +12:00
to-json.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
to-md.md Add pretty flag to to md (#2640) 2020-10-15 16:20:55 +13:00
to-toml.md Multiline scripts part 2 (#2795) 2020-12-18 20:53:49 +13:00
to-tsv.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
to-url.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
to-xml.md to-xml.md documentation update (#2253) 2020-07-25 20:19:15 +12:00
to-yaml.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
to.md Add pretty flag to to md (#2640) 2020-10-15 16:20:55 +13:00
touch.md touch: support multiple arguments (#2386) 2020-08-22 12:08:30 +12:00
uniq.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
update.md Add examples to update cmd (#2628) 2020-10-01 20:13:42 -05:00
version.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00
where.md Change f/full flag to l/long for ls and ps commands (#2283) 2020-08-02 06:30:45 +12:00
which.md Display aliases and custom commands in which; fix #2810 (#2834) 2021-01-02 06:40:44 +13:00
wrap.md First pass at updating all documentation formatting and cleaning up output of examples (#2031) 2020-06-24 06:21:47 +12:00

How do I get started?

Pick any command from the checklist and write a comment acknowledging you started work.

Instructions for documenting a Nu command of your choosing

Name the file after the command, like so:

command.md

Example: If you want to add documentation for the Nu command enter, create a file named enter.md, write documentation, save it at /docs/commands/[your_command_picked].md as and create your pull request.

What kind of documentation should I write?

Anything you want that you believe it best documents the command and the way you would like to see it. Here are some of our ideas of documentation we would love to see (feel free to add yours):

  • Examples of using the command (max creativity welcomed!)
  • Description of the command.
  • Command usage.

Anything else?

Of course! (These are drafts) so feel free to leave feedback and suggestions in the same file.

Happy Documenting.