From dc6357d9c66f5365a0310c2b5effd815dabe2d69 Mon Sep 17 00:00:00 2001 From: sajolida Date: Thu, 28 May 2015 18:30:13 +0000 Subject: Add bug about default behaviour of meta plugin for style sheets --- ...alternate_stylesheets_and_title_by_default.mdwn | 36 ++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn (limited to 'doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn') diff --git a/doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn b/doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn new file mode 100644 index 000000000..11dbfeecc --- /dev/null +++ b/doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn @@ -0,0 +1,36 @@ +The meta plugin, when used to add a stylesheet to a page, adds the +following attributes by default: + + - `rel="alternate stylesheet"` + - `title="mystylesheet"` + +The intent of this feature, according to the documentation is to "add a +stylesheet to a page". + + - By setting the `rel="alternate stylesheet"`, the additional + stylesheet is treated as an "alternate stylesheet" as described in + and is not +activated by default in the browser. The user is responsible for +activating them somehow. + - The `title` attribute is used to *group* several alternate style + sheets into a single one. This attribute is otherwise "purely +advisory" as defined in +. + +The current default behavior of the plugin implies having the additional +stylesheet not activated (if you don't set `rel="stylesheet"`) or only +one of them activated (if you add two stylesheets and not set the same +title for both). This was hard to understand for two of us while working +on and until we went and read +those W3C documents. + +I think that to match better the description of that feature, and to be +easier to comprehend in its default setting, the meta plugin should by +default: + + - Set `rel="alternate stylesheet"`. + - Not set any `title`. + +If we agree on this proposal, I'm willing to provide a patch. + +This applies to all versions since c8b4ba3 and until today. -- cgit v1.2.3