Add folder_include_patterns and file_include_patterns

[ferhtgoldaraz]

Extend the documentation of project folder declaration explaining a bit further it's optional values, and adding two that were not being mentioned

Please note, english is not my first language. It would be appreciated if you could read and ammend the changes if they happen to sound weird or something.

[FichteFoll]

You are referring to the "patterns" here, not the settings. While it can be interpreted to be the patterns, explicitly mentioning it is better. (It confused me at first.)
Same for the second part of this paragraph.

[FichteFoll]

Thanks for your contribution, I added a few comments.

Please try to restructure your additions to use semantic linefeeds as mentioned here.

[ferhtgoldaraz]

Thanks for your input, I've tried my best to improve the explanation and to update the style. I've done what I can with semantic line feeds, but I might have not got it, so feel free to reformat at will

[ferhtgoldaraz]

There are some file references written as foo that are not working. I'm gonna leave tham as foo for now, as :file:foo`` doesn't seem to work. I'm afraid I'm not familiar with that syntax

[FichteFoll]

The file role is define in Sphinx here. I'm not sure where you are seeing that the file role wouldn't work because it's being used throughout the code base (for example here).
Either way, just foo would be worse since restructured text requires double backticks for inline literals, that is foo.

I will take a look at your changes in detail later.

Edit: It appears that it will probably easier if I just take whatever you have here (by squashing probably) and then do my own pass.