-
Notifications
You must be signed in to change notification settings - Fork 15
Rewrite proposal #111
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Rewrite proposal #111
Conversation
inspired by #104.
@@ -23,28 +23,15 @@ Status Text: | |||
Boilerplate: omit conformance | |||
</pre> | |||
|
|||
# Intention # {#intention} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Intention" is an odd word, was introduced in the port to BS, and is not how I would have described this section.
|
||
This document is an articulation | ||
of W3C’s mission, values, purpose, and principles; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
reflects change to the document structure.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I kinda liked the original version. It doesn't mirror the document structure, but I think it gets more at the heart of what this document is trying to do. E.g. we're articulating our vision of the Web because this is how we express our values and purpose, but the actual purpose of the document is to articulate the values and purpose.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with fantasai. I mentioned at the AB F2F discussion that I really admire the previous Vision for putting into words the things I've heard Tim say over many years. I noted I never saw Tim put all these thoughts down all together in this way. That consolidation or articulation of Tim's Vision was great, and I wouldn't want to lose it.
Tim acted for many years as a trusted voice for his understanding for the potential of web technologies, and the importance of bearing in mind their impact on and for humanity (his vision). Many who joined the W3C were in alignment with and willing to come together to continue and expand positive and innovative ideas for the Web. As Tantek and others have noted, as W3C has moved to a Director-free status, we no longer have Tim as this one voice. Therefore to articulate and expand W3C's Vision for the web and web technologies is important so the organization is shown have a deep understanding on where we are heading and why.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(Note that Amy's comment was about retaining the bullet list for "vision of the Web", not this line.
in other words, our vision for W3C as an organization | ||
in the context of our vision for the Web itself. | ||
The goal of this vision is not to predict the future, | ||
but to define shared principles to guide our decisions. | ||
|
||
This document is not intended to be |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section is unnecessary.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it was useful, but it may indeed no longer be necessary.
in defining a World Wide Web that puts users first, | ||
by developing protocols and guidelines | ||
to empower an ethical, equitable, informed, and interconnected society. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added mission statement.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the addition of this section deserves its own issue and PR for discussion. I 100% agree with adding such a section. I think it's going in a good general direction. But I think we have a bit more to discuss on it before we declare it as our replacement for the existing mission statement, and I don't want to entangle getting consensus on this with the rest of the proposed improvements here.
# Introduction # {#intro} | ||
|
||
The World Wide Web was originally conceived | ||
as a tool for sharing information. | ||
It has evolved into a fundamental part of humanity, | ||
It has evolved rapidly into a fundamental part of humanity, | ||
sparking major social change by |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Restructured this paragraph to simplify flow.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+1 to this restructuring (which encompasses also the next diff chunk).
|
||
# Operational Principles for W3C # {#op-principles} | ||
|
||
The fundamental function of W3C is to provide an open forum |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Note "function" vs "purpose" in original.
Vision/Vision.bs
Outdated
* We strongly emphasize accessibility, | ||
* We create standards with an ethical intent to improve | ||
equity of access and participation on the Web. | ||
We will ensure the web platform meets broad goals |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
More operational/action-focused.
Vision/Vision.bs
Outdated
* Ensure the Web is trustworthy, | ||
by ensuring security and privacy for users. | ||
* Aim to reduce centralization in Web architecture, | ||
* We believe wide and interoperable implementation is a |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Interop is critical. Note the following pulls in some themes from previous multiple lists.
Man, I hate the way this sounds, but it is correct. Co-authored-by: Chris Needham <[email protected]>
Co-authored-by: Dominique Hazael-Massieux <[email protected]>
As per comment in #104
As per comment in #104 (comment)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
My top-level comment here is, I would like to see this broken down into multiple PRs, one for each high-level changeset. As I mentioned in #108 I think they deserve individual discussion, and combining them all into one changeset makes it hard to discuss, review, and meaningfully approve each change.
|
||
This document is an articulation | ||
of W3C’s mission, values, purpose, and principles; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I kinda liked the original version. It doesn't mirror the document structure, but I think it gets more at the heart of what this document is trying to do. E.g. we're articulating our vision of the Web because this is how we express our values and purpose, but the actual purpose of the document is to articulate the values and purpose.
in other words, our vision for W3C as an organization | ||
in the context of our vision for the Web itself. | ||
The goal of this vision is not to predict the future, | ||
but to define shared principles to guide our decisions. | ||
|
||
This document is not intended to be |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it was useful, but it may indeed no longer be necessary.
in defining a World Wide Web that puts users first, | ||
by developing protocols and guidelines | ||
to empower an ethical, equitable, informed, and interconnected society. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the addition of this section deserves its own issue and PR for discussion. I 100% agree with adding such a section. I think it's going in a good general direction. But I think we have a bit more to discuss on it before we declare it as our replacement for the existing mission statement, and I don't want to entangle getting consensus on this with the rest of the proposed improvements here.
# Introduction # {#intro} | ||
|
||
The World Wide Web was originally conceived | ||
as a tool for sharing information. | ||
It has evolved into a fundamental part of humanity, | ||
It has evolved rapidly into a fundamental part of humanity, | ||
sparking major social change by |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+1 to this restructuring (which encompasses also the next diff chunk).
Vision/Vision.bs
Outdated
and the trust it earns from them. | ||
The Web has had a tremendous impact on the world, | ||
and its impact will continue to grow in the future, | ||
as it expands reach, knowledge, education and services even more broadly. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oxford comma. Also “expands reach” is a bit of an awkward phrase, “reach” of what?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oxford comma resolved.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As noted in this morning's Vision TF call, I approve landing this (including edits/changes made since the call) and further iterating from there.
This brings forward the proposal from #103, taking guidance from comments there, #108, #104, and our 10-Aug-2023 meeting. I will put in comments in the PR to explain rationale for some pieces: the general goal was to reduce this to a much clearer set of sections:
Also note that this fixes #102 and #88.
Preview | Diff