Rewrite mounts description in config.md

[hqhq]

Also apply one sentence per line rule for list items.

Signed-off-by: Qiang Huang [email protected]

[wking]

On Mon, May 23, 2016 at 12:06:27AM -0700, Qiang Huang wrote:

1. Apple one sentence per line rule

“Apple” → “Apply”.

And I'm not sure there's consensus about whether the rule applies to
list items. I've been using single-sentence-lines in list items, but
unless there is a consensus it's probably not worth changing existing
instances unless you're also tweaking the content.

[wking]

I liked “Defaults to false” better as its own sentence, but I expect folks will get the idea either way ;).

[wking]

And defaults are a general enough idea that it may make more sense to mark them up (e.g. “readonly (bool, default: false) If true, then …”). So settings would either be required or have a default value.

[hqhq]

I liked “Defaults to false” better as its own sentence

I think it makes sense to combine them in one sentence, and it looks simpler, I'll change if more people think we should keep its own sentence.

And defaults are a general enough idea that it may make more sense to mark them up (e.g. “readonly (bool, default: false) If true, then …”). So settings would either be required or have a default value.

Since it's a general change for all such defaults usage in runtime-spec, I'll leave it as a separate discussion if needed.

[hqhq]

Updated.

[wking]

1895e07 looks good to me (with the exception of the default issue
1, and I'm fine spinning that out into a separate discussion 2).
I like your new, specific commit-summary a lot more too :).

[wking]

On Tue, May 31, 2016 at 11:10:29AM -0700, W. Trevor King wrote:

1895e07 looks good to me (with the exception of the default issue
1, and I'm fine spinning that out into a separate discussion [2]).

Is there any chance of this landing soon? I want to extend the spec
to talk about the ‘bind’ type and ‘rbind’ options 1, neither of
which are covered by the mount(8) FILESYSTEM-* MOUNT OPTIONS sections.
They are covered as long options in mount(8), but I think we need
some wording around them (and maybe --make-shared, --make-slave,
--make-rshared, etc.?), and I don't want to workup a PR for that
before we've dropped the Arch wiki as a lower layer of this spec :p.

[hqhq]

Rebased, ping @vbatts @mrunalp @crosbymichael

[wking]

On Thu, Jul 21, 2016 at 11:40:59PM -0700, Qiang Huang wrote:

Rebased…

1895e07 → 0e8e069 looks fine to me. Besides the context changes,
there's some ‘:’ → ‘,’ and a sentence break that look minor to me.

[hqhq]

@wking I consisted some ':' and ',' usage.

[wking]

On Fri, Jul 22, 2016 at 12:13:29AM -0700, Qiang Huang wrote:

@wking I consisted some ':' and ',' usage.

0e8e069 → 1752ce8 looks good to me.

[vbatts]

LGTM

[crosbymichael]

LGTM