Re: Message "Do not check this box without first reviewing with the community on the e-mail list."

It looks to me as if this checkbox is supposed to make it so the example
isn't shown on the page. However that seems counter-productive and useless.

In some cases concepts should have code examples. It is perfectly valid for
them to be there.

So, if this isn't what the checkbox does then what does it do? And further
why would a warning like this be put on something without consulting the ML
first? (Unless it is just a discussion I couldn't find, in which case a
link to the discussion of it after the warning would be nice.)


On Mon, Aug 12, 2013 at 4:49 PM, Julee <julee@adobe.com> wrote:

> Hi, folks:
>
> When editing a concept page,[1] I can across this note:
>
> Examples Section
> Not required (suppresses printing of the entire section when checked)
>
> *Note:* Do not check this box without first reviewing with the community
> on the e-mail list. This check box should be used only in rare cases.
>
> Could someone please help me understand: is it OK to add examples to
> concept pages? What does this message mean to prevent or encourage?
>
> Thanks much!
>
> Julee
> [1]
> http://docs.webplatform.org/w/index.php?title=css/concepts/overset&action=formedit
> ----------------------------
> julee@adobe.com
> @adobejulee
>