-
Notifications
You must be signed in to change notification settings - Fork 15
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
Rename Introduction to Background #183
Conversation
I don't think this should be done unless we rename Purpose "Introduction" and give matching anchor names to the sections. |
@cwilso I'm OK with that direction; was debating whether to do it and went with the minimal change option. Would you like me to update the PR? |
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'd rather keep "Introduction" as section header, similar to the Ethical Web Principles.
I don't think this is an improvement, and I'd rather not open the door for wordsmithing for an updated Note.
I'd prefer to close this PR with no changes, and discourage wordsmithing (would prefer contributors spend time on helping process the remaining outstanding open Vision project issues instead, as well as those expected from upcoming explicit wide review and horizontal reviews.)
I agree with Tantek, I would prefer to leave this as is. |
@tantek I think the Introduction to the Ethical Web Principles is in fact an introduction to the rest of the document; but the current "Introduction" for the Vision explains historical background and context, but doesn't really introduce the rest of the document. That's my issue here, and why I proposed the renaming. You could call it a preamble, but it's not an introduction. |
After reflecting on this further: I don't think it is right to rename the current "Introduction" as "Background". It is, in fact, an introduction to the document; why the concept exists, why we think it's important (it does put it in an historical context, but so does the EWP's introduction) and what the document does. HOWEVER:
I'll toss together a PR if this sounds like it would be an improvement. Other than that, though, I have to agree, I would still weigh in on "no change". |
This section is really about historical and contextual background; the actual “introduction” to the document is the previous section.
I'm seeing rough consensus here for "no change" so I'm closing accordingly, especially as this PR (and issues mentioned therein) is unnecessary for an updated Note. In addition, wordsmithing is not essential for publishing an updated Note, please defer any such suggestions, because they will almost certainly be moot in the context of feedback we get from wide review. |
This section is really about historical and contextual background; the actual “introduction” to the document is the previous section.
Preview | Diff