Nothing Special   »   [go: up one dir, main page]

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

Vision should have a Glossary #1

Closed
cwilso opened this issue Aug 4, 2022 · 6 comments
Closed

Vision should have a Glossary #1

cwilso opened this issue Aug 4, 2022 · 6 comments
Assignees
Labels
Project Vision Vision and Principles

Comments

@cwilso
Copy link
Collaborator
cwilso commented Aug 4, 2022

Originally filed at WebStandardsFuture/Vision#43.

@cwilso cwilso added the Project Vision Vision and Principles label Aug 4, 2022
@tantek
Copy link
Member
tantek commented Aug 16, 2022

Proposed resolution: accept & resolve this issue: there was no objection in prior discussion, and it will help make the Vision more understandable to a broader audience, while helping it stay succinct which helps keep the Vision more accessible to a broader audience.

Proposed next steps to close this issue:

  • create a Glossary file as a peer to the Vision document
  • stub it (explicitly) with scope (the Vision document) and one or a few obvious jargon terms from the Vision (e.g. “phishing”) with anchors
  • link to Glossary from the footer of the Vision document
  • link from the first occurence of a jargon term in the Vision to the specific term in the Glossary
  • add a “How to contribute” footer to Glossary encouraging proposed additions to grow the Glossary as necessary to define additional jargon terms in the Vision with broadly accepted uses & definitions within the W3C community, perhaps encouraging singular pull requests for terms that may require in depth discussion such as “centralization” or are otherwise contentious in actual practical use in W3C discussions.

Aside: in the interest of re-use, resources at https://www.w3.org/Glossary.html may be helpful, but let’s please avoid the trap of creating yet another “system” (to be unmaintained & abandoned) like https://www.w3.org/Terms

(Originally published at: https://tantek.com/2022/227/t2/)

@cwilso
Copy link
Collaborator Author
cwilso commented Aug 16, 2022

Ab approves of this proposal.

@jeffjaffe
Copy link

I suggest that where possible we link to existing definitions.

@LJWatson
Copy link
Contributor

Adding the comment I made during the AB meeting today: a glossary is a good idea, but we should take care that it's used for industry and/or W3C specific terms, and not as a dictionary because the original content is difficult to read/understand.

@tantek tantek self-assigned this Aug 24, 2022
tantek added a commit that referenced this issue Feb 7, 2023
As part of the goal of transparently admitting significant existing harms of the web, it makes sense to add malvertising adjacent to misinformation to the Introduction, per https://arstechnica.com/information-technology/2023/02/until-further-notice-think-twice-before-using-google-to-download-software/ for example. Note this is a "modern" (2000s+) problem, and the term itself is clearly defined in Wikipedia: https://en.wikipedia.org/wiki/Malvertising (which we could add as a reference in the glossary as part of #1 )
@TzviyaSiegman
Copy link
Contributor

Is this still needed or have terms been clarified?

@cwilso
Copy link
Collaborator Author
cwilso commented Jan 27, 2024

We have a non-Vision-specific glossary (https://w3c.github.io/AB-public/Glossary). That resolves this issue.

@cwilso cwilso closed this as completed Jan 27, 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
Projects
None yet
Development

No branches or pull requests

5 participants