Add custom CSS for pretty `rustdoc` alerts

[BD103]

Alerts are fun and a nice way to separate out information. We can use custom CSS to add these to bevy_lint's documentation.

See #152 for a starting point on this.

[mockersf]

This is already supported by rustdoc: https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#adding-a-warning-block

[BD103]

This is already supported by rustdoc: https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#adding-a-warning-block

Yes, but just for warning blocks! Other alerts such as

Note

Notes

Tip

Tips

Important

Important information

Caution

And caution blocks

are not supported.

I used the CSS for .warning as inspiration for my original draft.

[mockersf]

@GuillaumeGomez would there be interest in adding those to rustdoc?

[BD103]

@GuillaumeGomez would there be interest in adding those to rustdoc?

I'd be willing to open a PR for them, if there is! My idea is:

My **Markdown** content...

<div class="rustdoc-alert rustdoc-alert-tip">
  <div class="rustdoc-alert-title">Fun Fact!</div>

  Other Markdown `content`...

</div>

[GuillaumeGomez]

I actually offered to add more kinds of "important block" but the team rejected the idea. You can see the discussion about it here.

[BD103]

Got it! I'm still going to go ahead with #161 for bevy_lint, but thanks for the response. :)