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

Remove confusing "Equal-width multi-line" section from Grid docs. #30189

Merged

Conversation

mikelehen
Copy link
Contributor

Reading the grid docs from top to bottom, this section made no sense to me. I didn't understand why you wouldn't just use multiple rows, and I had no idea what w-100 meant, or how you'd "mix" it with "responsive display utilities".

Then I continued reading and got to https://getbootstrap.com/docs/4.4/layout/grid/#column-breaks which explains the same concept but with a much better explanation and examples (including the responsive display utilities).

It looks like the "Equal-width multi-line" section was added in 9010978 to resolve to #21967 as a way to document the existence of a Safari bug. But that bug has long since been fixed (Safari 10.1 came out in May 2017) and so I think it's reasonable to just drop this section and rely on the better docs further down in the guide.

Reading the grid docs from top to bottom, this section made no sense to me. I didn't understand why you wouldn't just use multiple rows, and I had no idea what w-100 meant, or how you'd "mix" it with "responsive display utilities".

Then I continued reading and got to https://getbootstrap.com/docs/4.4/layout/grid/#column-breaks which explains the same concept but with a much better explanation and examples (including the responsive display utilities).

It looks like the "Equal-width multi-line" section was added in 9010978 to resolve to twbs#21967 as a way to document the existence of a Safari bug.  But that bug has long since been fixed (Safari 10.1 came out in May 2017) and so I think it's reasonable to just drop this section and rely on the better docs further down in the guide.
@mdo
Copy link
Member

mdo commented Feb 16, 2020

This can probably go away with .row-cols classes, right @twbs/css-review?

@MartijnCuppens
Copy link
Member

Then I continued reading and got to getbootstrap.com/docs/4.4/layout/grid/#column-breaks which explains the same concept but with a much better explanation and examples (including the responsive display utilities).

Yup, this section is way clearer indeed.

This can probably go away with .row-cols classes, right twbs/css-review?

Indeed, therefore it would also be better to remove this confusing section.

@MartijnCuppens
Copy link
Member

Thanks for taking your time to make a PR for this, @mikelehen!

@MartijnCuppens MartijnCuppens added this to Inbox in v5 via automation Feb 16, 2020
@MartijnCuppens MartijnCuppens merged commit 1dcd496 into twbs:master Feb 16, 2020
v5 automation moved this from Inbox to Shipped Feb 16, 2020
olsza pushed a commit to olsza/bootstrap that referenced this pull request Oct 3, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
No open projects
v5
  
Shipped
Development

Successfully merging this pull request may close these issues.

None yet

3 participants