backdrop / backdrop-issues

Issue tracker for Backdrop core.
144 stars 40 forks source link

[DX][UX] Add the version of Bootstrap included in core to the status report #3782

Open jenlampton opened 5 years ago

jenlampton commented 5 years ago

As was mentioned in the virtual user group today, it would help people if we could show them which version of Bootstrap the layout system was using.

klonos commented 5 years ago

Related tasks that came up during the VUG:

(I will create separate issues for these tasks - just wanted to quickly add them here, so that they are not lost in time 🙂 )

olafgrabienski commented 5 years ago

Another related idea was to have documentation about available Bootstrap utility classes.

jenlampton commented 5 years ago

Actually, it was to document the utility classes provided by core (not from bootstrap). See https://github.com/backdrop-ops/api.backdropcms.org/issues/57

We don't include any of Bootstrap other than the grid system, but we could link to docs for that too I suppose. Maybe in the Status Report line!

stpaultim commented 2 years ago

Thinking about our OpenForce2022 participants. Is it reasonable to assume that they would know how to find out which version of Bootstrap we are using.

Can anyone provide a few hints on how one might get started with this issue. With a few hints, this might actually get a PR in the next few days.

bugfolder commented 2 years ago

To add the information as a line in the Status report, add an entry to the $requirements array in system_requirements() in system.install.

To find what version of Bootstrap we're using (and not get sidetracked by the generic usage of "bootstrap" to describe the startup process), do a case-sensitive search for "Bootstrap" (which turns up in file grid-float.css, which contains all the grid classes from Bootstrap 4.0.0-alpha.2).

jenlampton commented 10 months ago

We added a flexbox based gridsystem in https://github.com/backdrop/backdrop-issues/issues/698 on May 16, 2016, when we included the grid-flexbox.css file https://github.com/backdrop/backdrop/pull/1379/files#diff-514417dbf48261e08edd5dfc447345e07775d624b9f09180050145bda4e1e92c.

Unfortunately, we didn't include any documentation in that file, or anywhere else, that it was generated from bootstrap, or which version was used.

I happen to remember that this was Bootstrap v4 -- but because we included v4 before v4 was released on January 18, 2018, the final Bootstrap v4.0 is slightly different from what we have in core today.

It's probably important to document the differences between 4.0 and the Backdrop core version. (I've started an unpubished page on d.b.org)

I've created https://github.com/backdrop/backdrop-issues/issues/6345 for updating to Bootstrap version 5, and we can document those differences also.