Skip to content

Conversation

@ctsrc
Copy link
Contributor

@ctsrc ctsrc commented Sep 27, 2019

The rules matching a footer tag were originally there for styling of a sponsor logo (as shown by git blame) on crates.fyi.

None of the templates output a footer tag anymore, so this rule is unused.

What's more, this unused rule will interfere with the look of any docs outputs themselves when these contain one or more footer tags nested inside of blockquote like http://html5doctor.com/cite-and-blockquote-reloaded/ suggests that one might one to do when quoting some other work.

Specifically, you can see this happen in the docs for one of mine crates;

Originally, I was planning on suggesting that the rule be limited to be more specific, but since I see that it goes unused, I suggest removing it all-together.

The rules matching a `footer` tag were originally there for styling of a sponsor logo (as shown by `git blame`) on crates.fyi.

None of the templates output a `footer` tag anymore, so this rule is unused.

What's more, this unused rule will interfere with the look of any docs outputs themselves when these contain one or more `footer` tags nested inside of `blockquote` like http://html5doctor.com/cite-and-blockquote-reloaded/ suggests that one might one to do when quoting some other work.

Specifically, you can see this happen in the docs for one of mine crates;

  * https://docs.rs/persistence/0.0.2/persistence/#what-this-library-is-and-what-it-is-not
  * https://github.com/ctsrc/persistence/blob/2375f30ae37ac5b8fa42af96cd35afd66a79bd76/src/lib.rs#L81-L96

Originally, I was planning on suggesting that the rule be limited to be more specific, but since I see that it goes unused, I suggest removing it all-together.
Copy link
Contributor

@QuietMisdreavus QuietMisdreavus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice catch, thanks so much!

@QuietMisdreavus QuietMisdreavus merged commit c54815d into rust-lang:master Sep 30, 2019
@ctsrc ctsrc deleted the patch-1 branch October 1, 2019 06:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants