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
16863	"Multiple ""invalid option block"" errors when building docs"	Carl Meyer	nobody	"Using Sphinx 1.07, I get 8 errors like this on a fresh docs build:

{{{
/home/carljm/projects/django/django/django-git/docs/topics/i18n/localization.txt:262: (ERROR/3) Error in ""note"" directive:
invalid option block.

.. note::
    The default :file:`settings.py` file created by
    :djadmin:`django-admin.py startproject <startproject>` includes
    :setting:`USE_L10N = True <USE_L10N>` for convenience.
}}}

I think it's from lines beginning with a colon inside a directive (usually `.. note` or `.. warning`), which Sphinx is trying to interpret as option blocks for that directive.

If there's a way we could just turn that error off, that'd be nice. Otherwise we should probably fix these cases manually and try to avoid introducing new ones, it's a barrier to new docs contributors to have a bunch of ""known errors"" in the docs build."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Unreviewed	0	0	0	0	0	0