## Using the API
-Now that you're familiar with how the utilities API works, learn how to add your own custom classes and modify our default utilities. There are two ways you can do this:
+Now that you're familiar with how the utilities API works, you can modify the default utilities and add your own. This can be done in two ways:
-1. If you only need to override our default utilities or add new ones, we'll merge your `$utilities` variable with ours
+1. If you only need to override our default utilities or add new ones, we'll merge your `$utilities` variable with ours.
2. If you require more fine-grained control, we provide mixins to let you update our default utilities configuration.
You may also want to refer to parts of the utilities configuration in your Sass code, the value of a specific utility especially. We provide getter functions to access those.
### Adding or overriding utilities
-If your code declares a `$utilities` map before importing `bootstrap/scss/utilities`,
-it'll get merged with ours:
-
-- add new keys to create your own utilities
-- override existing utilities by using the same key
+If your code declares a `$utilities` map before importing `bootstrap/scss/utilities`, it'll be merged with our default map. Add new keys to create your own utilities and override existing utilities by using the same key.
```scss
$utilities: (
#### Adding and removing utilities
-`utilities-add` and `utilities-remove` mixins let you add and remove utilities from the configuration.
-Adding an existing utility will completely override it.
+`utilities-add` and `utilities-remove` mixins let you add and remove utilities from the configuration. Adding an existing utility will completely override it.
```scss
@import "bootstrap/scss/functions";
#### Updating utility options
-`utilities-set-option` and `utilities-set-options` let you configure one or several options of a utility.
-`utilities-set-options` will merge the new options with the existing ones by default,
-but you can provide a third `$merge: false` argument to completely override them.
+`utilities-set-option` and `utilities-set-options` let you configure one or several options of a utility. `utilities-set-options` will merge the new options with the existing ones by default, but you can provide a third `$merge: false` argument to completely override them.
And if the utility does not exist, both mixins will create a new one.
#### Updating utility values
-If you want to keep most of the default values for a utility, and just add, remove or update a few,
-replacing the `values` option can be a bit of a burden to maintain.
-`utilities-add-values` and `utilities-remove-values` mixins will help you make these targeted updates.
+If you want to keep most of the default values for a utility, and just add, remove or update a few, replacing the `values` option can be a bit of a burden to maintain. `utilities-add-values` and `utilities-remove-values` mixins will help you make these targeted updates.
```scss
@import "bootstrap/scss/functions";
### Getting utility values and options
-The `utilities-get-value` function let your grab a specific value of a utility.
-This can help you run some computations with it, either in Sass or with `calc()`.
-It also lets you access values that can be tweaked by other utilities,
-(like how `bg`, `text` and `border` can be tweaked by `bg-opacity`, `text-opacity` or `border-opacity` respectively).
+The `utilities-get-value` function let your grab a specific value of a utility. This can help you run some computations with it, either in Sass or with `calc()`. It also lets you access values that can be modified by other utilities, (like how `bg`, `text` and `border` can be affected by `bg-opacity`, `text-opacity` or `border-opacity` respectively).
```scss
@import "bootstrap/scss/functions";