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