Change docs files from .txt to .rst

[pfctdayelise]

This will mean that the contents are previewed on Github. It's much nicer to look at and also makes editing in the Github web interface quite easy. We have this already for CONTRIBUTING, README and HOWTORELEASE at the top level but in the docs/en dir. See e.g. https://github.com/pytest-dev/pytest/blob/master/CONTRIBUTING.rst

[oleksmarkh]

Hi and thanks for that amazing talk on EP15 :)

I would like to help with doc/en.

Looks like it's (mainly) quite a manual work, though content of these files is already kind of reStructured. So is it about renaming extensions of all the files + minor corrections + proof reading?

Could it mean also testing the docs (if all examples are still valid)?

Any priorities here? Should it be one giant complete PR if not?

[pfctdayelise]

Hi @markhovskiy, great! :)

I think it only needs to rename the files (git mv), as the contents are already RST as you noticed. Then there will be some scripts which are looking for .txt files and should be changed to look for .rst.

The code examples inside the docs should be fine as they don't need to be changed. Step 8 in https://github.com/pytest-dev/pytest/blob/master/HOWTORELEASE.rst has the info about how to build the docs. So build them locally and browse around a bit to make sure things still seem to be working correctly, is my suggestion.

[Akasurde]

@oleksmarkh , @pfctdayelise - I would love to work on this.

[oleksmarkh]

@pfctdayelise , sorry for not creating a PR yet. Planning to finally do it till 04.08 evening.
@Akasurde , we could even do it together, if you want - for instance, I can help with testing all those files built. If not, just ignore me and post your PR straight away :)

[Akasurde]

@pfctdayelise Let us do it together then

[pfctdayelise]

@Akasurde I think you meant to address @oleksmarkh, since you two are keen I won't get involved, but I will review it when there is a PR :)

[Akasurde]

@oleksmarkh can you please check PR #912 ?

[oleksmarkh]

@Akasurde , it fails. As it says, continuous-integration/appveyor fails because your branch can't be merged. Is it up to date?

Anyway, looks like either/both /Makefile and/or /doc/en/Makefile aren't updated. I'm not yet sure if those are required to fix docs generation.

[Akasurde]

I have made some changes in PR #912 , build is passing for me.

[oleksmarkh]

@Akasurde , I've tested #915, looks good. Thanks for taking it :)

[nicoddemus]

Just merged it, thanks everyone! 😄