docs/guidelines/index.rst
##########
Guidelines
##########
.. note::
This section describes guidelines for several front-end related
technologies. We advise you to follow them. However it is sometimes
necessary to `break the rules <https://www.youtube.com/watch?v=Xet5NcbQQ2A>`_
in which case you have to watch `this video <https://www.youtube.com/watch?v=Xet5NcbQQ2A>`_
and **leave a comment** describing why this was necessary.
.. toctree::
:maxdepth: 2
general
comments
markup
styles
javascript