Why do the Author Profile docs suggest modifying _utilities.scss?

[ohadschn]

https://mmistakes.github.io/minimal-mistakes/docs/layouts/#author-profile

Start by copying _utilities.scss <site root>/_sass. Open it up to the icon section (it’s near the bottom) and nest a new class beneath .social-icons that matches the one used to declare the Font Awesome icon. In our case .fa-reddit.

Isn't it more desirable (simpler and more gem upgrade safe) to edit main.scss? It seems to work...

[mmistakes]

That bit of documentation was likely written before there was a Ruby gem version.

Best practice when writing Sass is to break up your styles into components, utility classes, mixins, functions, variables, etc. That is the point of view I was taking when I built the themes and documented how and where to update the social icon classes.

So it depends. If you're a repo forker, editing _utilities.scss is the way to go. If you're Ruby gem installer, then dropping in your styles wherever it makes sense to augment the styles is best. The docs could be probably updated to mention both approaches, but that might further complicate things and be too prescriptive.

[mmistakes]

Note to self: links to _variables.scss and _utitlities.scss are broken and need updating to new paths under /_sass/minimal-mistakes.

Fixed in 423ba0a

[stale]

This issue has been automatically marked as stale because it has not had recent activity.

If this is a bug and you can still reproduce this error on the master branch, please reply with any additional information you have about it in order to keep the issue open.

If this is a feature request, please consider whether it can be accomplished in another way. If it cannot, please elaborate on why it is core to this project and why you feel more than 80% of users would find this beneficial.

This issue will automatically be closed in 7 days if no further activity occurs. Thank you for all your contributions.