id summary reporter owner description type status component version severity resolution keywords cc stage has_patch needs_docs needs_tests needs_better_patch easy ui_ux 19317 Make warning blocks distinguishable Tome Cvitan nobody "This is suggestion to make the warning block in the docs distinguishable from the note blocks, as they contain a different type of information. Most (but not all) instances of the warning block are written like this: {{{ .. warning:: }}} This way the blocks get the class ""warning"", which might not be a specific enough target for css styling. The ""philosophy"" and ""behind the scenes"" blocks on the other hand use the following syntax: {{{ .. admonition:: Philosophy }}} In the example, the div gets a class of ""admonition-philosophy"". This is then referred to in the spinx theme css and gives the block a philosophy icon. The suggestion is to use the same notation for warning boxes: {{{ .. admonition:: Warning }}} This is already used in a few places in the docs. With this, the divs get the ""admonition-warning"" class, to which we can safely apply a different styling - my suggestion is an orange border and an orange icon. A suggested icon and a patch for the sphinx theme css are attached, as well as a screenshot of the result." Cleanup/optimization closed Documentation dev Normal fixed Accepted 0 0 0 1 0 0