Skip to content
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

Closed
wants to merge 1 commit into from
Closed

Conversation

fantasai
Copy link
Contributor

@fantasai fantasai commented Sep 30, 2024

This section is really about historical and contextual background; the actual “introduction” to the document is the previous section.


Preview | Diff

@tantek tantek added the Project Vision Vision and Principles label Sep 30, 2024
@tantek tantek changed the title [Vision] Rename Introduction to Background Sep 30, 2024
@cwilso
Copy link
Collaborator

cwilso commented Sep 30, 2024

I don't think this should be done unless we rename Purpose "Introduction" and give matching anchor names to the sections.

@fantasai
Copy link
Contributor Author

@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?

@tantek tantek self-requested a review October 2, 2024 21:47
Copy link
Member

@tantek tantek left a 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.)

@frivoal
Copy link
Contributor

frivoal commented Oct 3, 2024

I would support the combined rename suggested by @fantasai and @cwilso, but I can also live without doing it.

@wareid
Copy link

wareid commented Oct 3, 2024

I agree with Tantek, I would prefer to leave this as is.

@fantasai
Copy link
Contributor Author

fantasai commented Oct 3, 2024

@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.

@cwilso
Copy link
Collaborator

cwilso commented Oct 4, 2024

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 do think a positive change that helps the issue @fantasai is calling out could be made by taking the current "purpose" section, and

  1. using the first paragraph of current purpose section up in place of the abstract (they say nearly the same thing), and
  2. moving the Goals list from the current purpose to the end of the introduction, which tightens up its utility as an introduction.

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.
@tantek
Copy link
Member

tantek commented Oct 8, 2024

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.

@tantek tantek closed this Oct 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Project Vision Vision and Principles
5 participants