7

I am asking this here, as suggested in the chat

command-line (and the associated tag) is a bit vague and can be misleading.

Should it be Unix or windows-oriented? I think there should be two separate documentation entries to avoid confusion, and clean up the documentation.

The current structure forces us to cover both cases, which complexifies the write up, and might not be useful to users who are looking it up for a specific environment anyway.

What do you think? Any feedback?

5
  • 5
    I do not believe you can have documentation about something associated to many independent and, in some cases, totally unrelated bunch of tools. Better is to stick to document tags that are concrete.
    – Braiam
    Commented Aug 19, 2016 at 13:48
  • While that's true, I think there is a value writing documentation about a subset of tools (maybe coreutils, for instance; or even Busybox commands). The documentation should in my (very personal) view be a start where beginners can start, and I remember struggling with commands as simple as pwd when I was young (by simply forgetting them and not having an easy way to find them back). If more people beleive there should be no such thing as a command-line documentation, however, then the section should simply be removed.
    – MayeulC
    Commented Aug 19, 2016 at 14:10
  • How is coreutils or busybox related to programming in first place? Lets ask the important questions here.
    – Braiam
    Commented Aug 19, 2016 at 14:33
  • 1
    Here's another vote for only documenting narrower tags (bash, cmd, whatever). We could either not have command-line Docs, or just use them to redirect to the other tags' Docs.
    – Frank
    Commented Aug 19, 2016 at 16:26
  • @Braiam - I though you were speaking about command line itself (that is, treating ls, cat, ln, etc as independent and unrelated tools). But from your answer, I get you were talking about multiple environment/shells/whatever. Somewhat different.
    – MayeulC
    Commented Aug 21, 2016 at 0:04

0

Browse other questions tagged .