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

DRAFT: Differentiate between two guides #37663

Closed
wants to merge 4 commits into from
Closed

DRAFT: Differentiate between two guides #37663

wants to merge 4 commits into from

Conversation

estelle
Copy link
Member

@estelle estelle commented Jan 15, 2025

Two guides had the exact same name.
This changes some of the links to the guide more appropriate for the content and changes the name of the guide for the links pointing to the grid item alignment guide.
The guide itself has been updated in a separate PR.
I am separating this out because that PR is getting huge.

part of openwebdocs/project#216
the guide is in draft, but not linking to the particular PR as the draft PR keeps getting borked so the # may change.

@estelle estelle requested review from a team as code owners January 15, 2025 20:58
@estelle estelle requested review from chrisdavidmills and removed request for a team January 15, 2025 20:58
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs Content:Glossary Glossary entries Content:Guide Guide docs size/s [PR only] 6-50 LoC changed labels Jan 15, 2025
Copy link
Contributor

@chrisdavidmills chrisdavidmills left a comment

Choose a reason for hiding this comment

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

@estelle these changes make sense, although I did have some comments about consistently using the article title as the link text. Some of the choices of link text here seem a bit weird to me.

@@ -248,7 +248,7 @@ In [block layout](/en-US/docs/Web/CSS/CSS_box_alignment/Box_alignment_in_block_a

- [Basic concepts of flexbox](/en-US/docs/Web/CSS/CSS_flexible_box_layout/Basic_concepts_of_flexbox)
- [Aligning items in a flex container](/en-US/docs/Web/CSS/CSS_flexible_box_layout/Aligning_items_in_a_flex_container)
- [Box alignment in CSS grid layouts](/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout)
- [Box alignment in CSS grid layouts](/en-US/docs/Web/CSS/CSS_box_alignment/Box_alignment_in_grid_layout)
Copy link
Contributor

Choose a reason for hiding this comment

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

It feels like a bit of a nitpick, but should you use the actual name of the article on links like this, where you are providing the name of the article as the link text?

The actual name is "Box alignment in grid layout".

Copy link
Member Author

Choose a reason for hiding this comment

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

updated

@@ -74,4 +74,4 @@ The grid specification originally contained the definition for the properties {{
- [Box alignment in multiple-column layout](/en-US/docs/Web/CSS/CSS_box_alignment/Box_alignment_in_multi-column_layout)
- [Box alignment for block, absolutely positioned and table layout](/en-US/docs/Web/CSS/CSS_box_alignment/Box_alignment_in_block_abspos_tables)

- [Alignment in grid layout](/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout)
- [Aligning items in CSS grid layout](/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout)
Copy link
Contributor

Choose a reason for hiding this comment

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

This link text is totally different to the article title, for seemingly no reason. "Box alignment in grid layout"?

They should all be consistent with each other, in cases where it makes sense to use the article title as the link text.

Copy link
Member Author

Choose a reason for hiding this comment

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

That article had its name changed but is still in draft. I can draft this PR until they're both ready to go.

Copy link
Contributor

Choose a reason for hiding this comment

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

Ah, OK. Yup, sounds like a good idea

Copy link
Member Author

Choose a reason for hiding this comment

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

see #38004

@estelle estelle marked this pull request as draft January 17, 2025 21:25
@estelle estelle changed the title Differentiate between two guides DRAFT: Differentiate between two guides Jan 17, 2025
@github-actions github-actions bot added the merge conflicts 🚧 [PR only] label Jan 29, 2025
Copy link
Contributor

This pull request has merge conflicts that must be resolved before it can be merged.

@bsmth
Copy link
Member

bsmth commented Feb 3, 2025

For the conflict, files/en-us/web/guide/css/css_layout/index.md is deleted on main, so you'd want to update https://github.com/mdn/content/blob/main/files/en-us/web/css/guides/index.md instead

@estelle estelle closed this Feb 6, 2025
@estelle estelle reopened this Feb 6, 2025
@estelle estelle closed this Feb 6, 2025
@estelle estelle deleted the guide_name branch February 6, 2025 23:33
@estelle
Copy link
Member Author

estelle commented Feb 6, 2025

moved to #38009

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:CSS Cascading Style Sheets docs Content:Glossary Glossary entries size/s [PR only] 6-50 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants