Expansion of "Customizing Bootstrap", extending using compiled CSS strategy. #10509
Conversation
…nd akward) .bs-callout-info segment with an expanded description of the base Bootstrap CSS development process
A major overhaul of the "Customizing Bootstrap" section including: * Expanded on the strategy of extending the compiled CSS. * Placing the component customization example in an info-panel. * Renaming the "Removing potential bloat" section to "Controlling bloat" and placing that in its own danger-panel.
…nt that all sections at this level possess.
…ompiling with LESS.
| <p class="lead">Bootstrap is best maintained as a separately versioned package in your development environment. This makes updating and upgrading Bootstrap easier in the future. To customize Bootstrap, create a new stylesheet, using LESS or just plain CSS, to house your customizations.</p> | ||
|
|
||
| <p>Bootstrap's developers use the following steps to author and assemble CSS. This knowledge may help you pick a customization strategy that's right for you.</p> | ||
| <p><strong>First the CSS source code is authored and maintained in LESS files</strong> named for their functionality. For example, in files named <code>grid.less</code>, <code>forms.less</code>, and many others. If you are comfortable using build tools, then consider using LESS to customize Bootstrap.</p> |
There was a problem hiding this comment.
"First, the..."
The second sentence here sounds incomplete. Perhaps use "For example, in grid.less you'll find the code for generating our grid system's CSS."
|
Let's stick with the callouts for now instead of the panels, btw. I've tweaked their style a bit in master, so that should help with the longer blocks of text and other content. |
|
Also, <3—thanks! |
…; did this wherever it made lexical sense. The remaining instances of 'compiled' are actions, not adjectives.
|
Ping. Wondering, is this PR good-to-go? I think I got everything. Anything else? |
|
Ping This PR seems stalled for some reason. I'd like to continue improving The state of So may I ask, please pull it before merging becomes a pain, close it so I know it's dead, or tell me what's needed to continue this PR forward. |
|
The HTML validator says you have an extra unmatched |
|
Good catch @cvrebert. Fixed. And a few other things tidied as well. |
|
/cc @mdo |
|
A Git question: This pull request is nearly three weeks old now. What's the best workflow to merge or rebase this branch against master so it remains viable, and an easy-pull, without screwing-up? Thoughts? |
See my current branch live, in action here: http://bs3.sbc.io/getting-started/#customizing.
In summary:
.bs-callout-infosegment -- which was a placeholder anyway -- with an expanded description of Bootstrap's CSS development process. This clarifies that the user has 2 hooks: either customize at the .LESS stage, or customize using the compiled CSS.This is just a start but I reckon this is usable right now, way better than what we currently have.
Coming soon would be an equal treatment about customizing at the LESS stage, and perhaps a short table comparing and contrasting the two strategies.