Re: [PATCH] git-commit.txt: Order options alphabetically

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



2010-12-02 00:52 Kevin Ballard <kevin@xxxxxx>:
> On Dec 1, 2010, at 2:45 PM, Jari Aalto wrote:
>> What is the reason --reset-author is in that position? What
>
> It's entirely possible...

The reader have to guess "imagined groups"? Hm, that's interesting.

>> To me the git-pages do not look that professional...
>
> You seem overly concerned with the visual aesthetics and not at all with the
> actual content.

Humans read visually. It's built in. Distractions slow down. Try writing

    abcdef = 1
    x123.213.123..123. = 4
    sdaÃlkasd = 1

vs.

    abcdef              = 1
    x123.213.123..123.  = 4
    sdaÃlkasd           = 1

There is a reason why people like Excel cells. Not my invention.

>> When the pages list options in alphabetical order, it doesn't take long
>> to compare commands: similarities and differences in options, or missing
>> options, or inconsistencies for that matter.
>
> Why would you compare commands like that? There's really no reason at all to
> believe that the -c flag for one command is even related to the -c flag for
> another command.

I take it you have written loads of software. The reasons come from
standard Software Development and Quality auditions. Git's command line
is inconsistent in many places and there is room for improvement.
Documentation is one way to spot those.

And ther eis perfect reasons to, again, expect consistency on some level
of command options to mean same thing

Like why some commands need number in:

    -n NUMBER

Whereas other's use:

    -NUMBER

Examples like that.

Jari

--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]