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

glossary: update baseline #33365

Merged
merged 3 commits into from
May 2, 2024
Merged

glossary: update baseline #33365

merged 3 commits into from
May 2, 2024

Conversation

PassionPenguin
Copy link
Contributor

@PassionPenguin PassionPenguin commented May 2, 2024

Description

links modification

  1. baseline/index.md wikipedia link removal
  2. baseline/typography/index.md
    1. wikipedia link name modified from baseline => baseline (typography)
    2. chars of font => most chars of font
    3. add east-asian baseline description
  3. baseline/compatibility/index.md wikipedia link added: Baseline_(configuration_management)

Motivation

  1. & 2.1 the wikipedia disambigious page got so many unrelated information that is unrelevent to the glossary (baseline*) we describe here.

    will it be better to link to baseline(typograph) and add a link to baseline(configuration management?), or just delete the link in baseline, add it respectively in baseline/compatibility & baseline/typography

2.2 some chars, like those have descenders(e.g. y), does not rest on it, but below the baseline its descender extends.

2.3 add description for east-asian chars baseline

Additional details

image

w: baseline_(configuration management) is related to baseline in Configuration, or in VCS, where it defines:

a baseline is an agreed description of the attributes of a product, at a point in time, which serves as a basis for defining change.[1] A change is a movement from this baseline state to a next state. The identification of significant changes from the baseline state is the central purpose of baseline identification.

w: baseline_(typography) is related to baseline in typography, where it defines:

In European and West Asian typography and penmanship, the baseline is the line upon which most letters sit and below which descenders extend.

Related issues and pull requests

Fixes #33349
Related PR #26676 where in the merge, baseline/compatibilitiy was added and baseline's link to wikipedia was modified to a disambigious link (w: baseline_(typography) => w: baseline).

@PassionPenguin PassionPenguin requested a review from a team as a code owner May 2, 2024 01:41
@PassionPenguin PassionPenguin requested review from pepelsbey and removed request for a team May 2, 2024 01:41
@github-actions github-actions bot added Content:Glossary Glossary entries size/s 6-50 LoC changed labels May 2, 2024
Copy link
Contributor

github-actions bot commented May 2, 2024

Preview URLs

External URLs (1)

URL: /en-US/docs/Glossary/Baseline/Typography
Title: Baseline (typography)

(comment last updated: 2024-05-02 05:13:26)

@@ -61,3 +61,4 @@ If you have questions, feedback, or want to help update and expand the features
- [web-platform-dx/web-features repository](https://github.com/web-platform-dx/web-features)
- [W3C WebDX Community Group](https://www.w3.org/community/webdx/)
- [mdn/browser-compat-data repository](https://github.com/mdn/browser-compat-data)
- [Baseline (Configuration Management)](<https://en.wikipedia.org/wiki/Baseline_(configuration_management)>) on Wikipedia
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about this one but I'm not sure. Baseline in https://developer.mozilla.org/en-US/docs/Glossary/Baseline/Compatibility is really a "marketing term", it's related to but not the same as baseline in configuration management.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

uhmm..i did think about this, as i first found the term configuration baseline;

A set of specifications for a system, or Configuration Item (CI) within a system, that has been formally reviewed and agreed on at a given point in time, and which can be changed only through change control procedures. The baseline configuration is used as a basis for future builds, releases, and/or changes. 1

may u correct my understanding, that baseline table in mdn, is about "whether it's a feature that works in almost all, most, and few browsers", then it will match "the features can only be changed through change control procedures. used as a basis for future builds, releases and/or changes" (given that browser will and only will change the feature in future builds, releases and/or changes)..?

Footnotes

  1. csrc.nist.gov

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

well....if not that matched, then should not the link w: baseline appears in baseline/index.md... as it's totally meaningless...(only one link in w: baseline points to both of the sub-entries's relevent information)

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

well....if not that matched, then should not the link w: baseline appears in baseline/index.md... as it's totally meaningless...(only one link in w: baseline points to both of the sub-entries's relevent information)

I agree that we should remove the link to https://en.wikipedia.org/wiki/Baseline in https://developer.mozilla.org/en-US/docs/Glossary/Baseline.

About the link to https://en.wikipedia.org/wiki/Baseline_(configuration_management) in https://pr33365.content.dev.mdn.mozit.cloud/en-US/docs/Glossary/Baseline/Compatibility, I'm 50/50. I do understand that they are related.

it will match "the features can only be changed through change control procedures. used as a basis for future builds, releases and/or changes" (given that browser will and only will change the feature in future builds, releases and/or changes)..?

Not really. All browser features will only be changed "in future builds, releases and/or changes)". All browsers use change control for all features, whether they are "Baseline features" or not.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

emmm....yeap..

1. which the characters rest => which **most of** the characters rest
2. add east-asian scripts description?
@PassionPenguin PassionPenguin changed the title glossary: update links to wikipedia glossary: update baseline May 2, 2024
Copy link
Collaborator

@wbamberg wbamberg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 nice, thank you @PassionPenguin !

@wbamberg wbamberg merged commit 3e4bc80 into mdn:main May 2, 2024
8 checks passed
@PassionPenguin PassionPenguin deleted the baseline-patch branch May 2, 2024 05:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Glossary Glossary entries size/s 6-50 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

glossary: external see-also link
2 participants