737121 - Meaningful errors in the RestructuredText parser

Status: RESOLVED WONTFIX

(Mozilla Reps Graveyard :: reps.mozilla.org, task)

Description

[Stephen Donner [:stephend] Not actively reading bugmail]

On https://reps-dev.allizom.org/u/fredy/, there are a few Python error messages, like so:

System Message: WARNING/2 (<string>, line 49); backlink
Duplicate explicit target name: "august".

System Message: ERROR/3 (<string>, line 52)
Document may not end with a transition.
Docutils System Messages

System Message: ERROR/3 (<string>, line 38); backlink
Duplicate target name, cannot be used as a unique reference: "august".

System Message: ERROR/3 (<string>, line 40); backlink
Unknown target name: "image".

System Message: ERROR/3 (<string>, line 45); backlink
Unknown target name: "python".

Comment 1

[Stephen Donner [:stephend] Not actively reading bugmail]

Attachment: Screenshot

Comment 2

[Giorgos Logiotatidis [:giorgos]]

Hey Stephen,

thanks for reporting this. Fredy is a great guy who helps us with QA on our end ;) He spent a couple of hours testing the restructuredtext support in our website, as you can see.

Regarding the error, this is to notify you that your restructuredtext is broken and it's generated from the django markup module. I understand it's not beautiful but this is intended behavior when your input in incorrect. It's not an error in our code. 

Additionally restructuredtext support is still a "hidden" feature in our website, we don't advertise it so most reps won't even notice ;)

That being said I downgrade this bug to normal and I leave it open so in the future we can display nicer error messages when your markup is invalid. 

Thanks!

Comment 4

[Stephen Donner [:stephend] Not actively reading bugmail]

Thanks, Giorgos, for the explanation; makes perfect sense!

Comment 5

[Pierros Papadeas [:pierros]]

We are now using MarkDown as a syntax markup, so closing this bug