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

My guess is that the logic for this comes from when Alex et al were developing the templates. I would imagine that Alex and Chris Mills would be the best bet for understanding the historical reasons behind it, though like you, I cannot fathom why we’d suppress samples on a page like this.

From: Jonathan Garbee [mailto:jonathan.garbee@gmail.com]
Sent: Monday, August 12, 2013 2:21 PM
To: WebPlatform Public List
Subject: 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<mailto: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<mailto:julee@adobe.com>
@adobejulee