how-we-work icon indicating copy to clipboard operation
how-we-work copied to clipboard

Guiding principles

Open rkirsling opened this issue 7 years ago • 4 comments

It seems it would be helpful to have a document of "guiding principles" for newcomers to keep in mind when making a proposal or prioritizing concerns that arise when evaluating proposals. (Perhaps this would also serve to address some ES Discuss noise, as @waldemarhorwat and @ljharb were relating.)

My understanding is that such principles may not currently exist in an official sense, but even a simple list of the things "in the ether" among the committee would be wonderful to have.

Whether this should exist as its own document or as a preface to, e.g., #1 is an open question.

rkirsling avatar May 23 '18 17:05 rkirsling

See https://github.com/tc39/Reflector/issues/106 as well

ljharb avatar May 23 '18 17:05 ljharb

I tried to compile some of these "guiding principles" but the feedback that we got was generally that there isn't enough convergence to call these "principles" more so than something along the lines of "considerations". That is, there isn't a fixed set of unbreakable rules/principles but rather a collection of trade-offs that are used in conjunction.

So, currently, we have these "considerations" in the terminology doc in the following sections:

https://github.com/tc39/how-we-work/blob/master/terminology.md#considerations https://github.com/tc39/how-we-work/blob/master/terminology.md#on-growing-a-language

Does that make sense?

samuelgoto avatar May 23 '18 17:05 samuelgoto

On a related and conflicting note, I was just sent this with a set of guiding principles for HTML/CSS which holds mostly:

https://www.w3.org/TR/html-design-principles/#support-existing-content

samuelgoto avatar May 23 '18 17:05 samuelgoto

... currently, we have these "considerations" in the terminology doc ...

Yeah, I suppose those should cover the ground I'm looking for after all—I'm just hoping for a sort of distilled rationale / list of tenets to weigh into consideration. Certainly not expecting any kind of enforcement per se, just something to support community cohesiveness / signal-to-noise ratio.

That said, I feel like "glossary" and "considerations" are each deserving of their own document. :smile:

... a set of guiding principles for HTML/CSS ...

Nice! This is exactly the kind of thing I was visualizing. Perhaps we could have our own, with this as inspiration?

rkirsling avatar May 23 '18 18:05 rkirsling