Change short options for 'jekyll docs'

[maul-esel]

I'd expect the short versions of the options for jekyll docs to be the same as for jekyll serve. Or is there any reason to name them differently?

Minor backwards-incompatibility in the interface, but IMHO really tolerable.

[parkr]

I'm ambivalent. @mattr-?

[mattr-]

When did we add the docs command? How many versions has it been different from serve?

Based on the answers to those questions, I don't think this is a change we can introduce right now since the docs command has been present since 1.1. Making it compatible with serve is a backwards incompatible change in one of our public APIs and would required a major version bump from my point of view. This is a very strict interpretation of SemVer, but one that I think serves us best in the long run.

[parkr]

Fair and I agree with the strict interpretation of SemVer, but I think the significance of changing these is a bit overblown. I'd be most concerned with breaking scripts that run docs command (e.g. script/offline launches docs server in background and a server for the current site) where the default port would cause conflict.

I'd be inclined to say this is such a minor change that the significance of the backwards-compatibility is small. If only we could deprecate it more nicely (by offering -p but printing a warning message)...

[kelvinst]

I like the deprecation proposal, keep the original behavior by now with a warning of deprecated option is good enough for me. Maybe after 2.0 we can cut the old option off...

[parkr]

Ready for these 💃

Can you please submit a new PR? mojombo:master is 💀