Enable RST linting bears on this repo

[Mixih]

Currently, this repository is not being linted for rst problems. Please enable both reSTLintBear and RSTCheckBear. There are probably issues with the rst which need fixing first. Please spawn newcomer sub-issues for each one found, or fix them yourself.

[mridubhatnagar]

Hey, I went through
1)http://docs.coala.io/en/latest/Users/Tutorial.html .
2) Went through .coafile

Can you guide me how to proceed further. So that I can make some progress and help in resolving this issue.

[Mixih]

see the rst section int he main coala repo for some inspiration. You probably want both reSTLintBEar and RSTCheckBEar.

[mridubhatnagar]

Went through rst section, .coafile in the main coala repo. Seems reSTLintBear is already present in .coafile.
do I just need to add RSTCheckBear.
And files=docs/**/.rst .

[mridubhatnagar]

Please can someone look into this commit. And tell me regarding the needful changes before I raise a final PR. Changes other than the newline that needs to be added.

[jayvdb]

@Mixih , @mridubhatnagar , @SanketDG , in light of coala/coala-bears#1716 , why do we want to enable both reSTLintBear and RSTCheckBear. What advantages are their for using reSTLintBear ? Does it show errors that RSTCheckBear doesnt show?

RSTCheckBear already solves these problems ( rstcheck/rstcheck#1 ) with config like:

[rstcheck]
ignore_directives=one,two,three
ignore_roles=src,RFC

[SanketDG]

@jayvdb I just ran stuff on two bears, and it looks like rstcheck has sphinx support by default, so it reports none of those, there is not even config file needed!

@mridubhatnagar please remove reSTLintBear and only use RSTCheckBear 👍

[mridubhatnagar]

Sure, Thanks . Shall do it by today.

[mridubhatnagar]

If I keep just the RSTcheckBear. Title underline too short error stems up. Even after changing the length of underline. I am using python 3.4.2.