docs and readme

docs/troubleshooting.rst

@@ -1,12 +1,10 @@
-.. _troubleshooting:
-
+***************
 Troubleshooting
-===============
+***************
 
-.. _troubleshooting-languagemissing:
 
 Consumer warns ``OCR for XX failed``
-------------------------------------
+####################################
 
 If you find the OCR accuracy to be too low, and/or the document consumer warns
 that ``OCR for XX failed, but we're going to stick with what we've got since
@@ -20,10 +18,9 @@ box, and your documents are written in Spanish you may need to run::
     apt-get install -y tesseract-ocr-spa
 
 
-.. _troubleshooting-convertpixelcache:
 
 Consumer dies with ``convert: unable to extent pixel cache``
-------------------------------------------------------------
+############################################################
 
 During the consumption process, Paperless invokes ImageMagick's ``convert``
 program to translate the source document into something that the OCR engine can
@@ -48,10 +45,9 @@ that's actually on a physical disk (and writable by the user running
 Paperless), like ``/var/tmp/paperless`` or ``/home/my_user/tmp`` in a pinch.
 
 
-.. _troubleshooting-decompressionbombwarning:
-
 DecompressionBombWarning and/or no text in the OCR output
----------------------------------------------------------
+#########################################################
+
 Some users have had issues using Paperless to consume PDFs that were created
 by merging Very Large Scanned Images into one PDF.  If this happens to you,
 it's likely because the PDF you've created contains some very large pages
@@ -72,4 +68,4 @@ with a DPI of 300, then merging the images into the single PDF with
 For more information on this and situations like it, you should take a look
 at `Issue #118`_ as that's where this tip originated.
 
-.. _Issue #118: https://github.com/the-paperless-project/paperless/issues/118
+.. _Issue #118: https://github.com/the-paperless-project/paperless/issues/118