doc: GRASS Programming Style Guide

[petrasovaa]

This is an attempt to consolidate and update documentation for code contributors into a style guide:

• The idea is to focus on style and best practices, contributing through GitHub is not described here.
• The source are the files from submitting folder (originally converted from Trac wiki), I tried to extract useful and relevant things, this PR removes those files.
• Another source is @wenzeslaus' workshop on development and best practices
• I kept it as one document right now, but I am open to splitting it up or restructuring it.

I would appreciate any feedback on this. For example I don't have a lot about pylint usage there or best practices in C.

[echoix]

If I recall correctly, there is a special handling for a file named CONTRIBUTING.md, a bit like README files. If we really want to use a file in the doc subfolder, we could create a contributing file and link to the full docs in it.

[veroandreo]

Looks good to me, it covers all aspects simply and concisely including examples :)

[echoix]

If I recall correctly, there is a special handling for a file named CONTRIBUTING.md, a bit like README files. If we really want to use a file in the doc subfolder, we could create a contributing file and link to the full docs in it.

The docs are here: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors

There are multiple paths that GitHub's UI will integrate these contribution guidelines on PRs for new users, or for other users if that document changes since their last contribution.

I think we should take advantage of it instead of inventing our own and being left to make it discoverable by our own too.

Our page looks like this:

https://github.com/osgeo/grass/contribute

[petrasovaa]

If I recall correctly, there is a special handling for a file named CONTRIBUTING.md, a bit like README files. If we really want to use a file in the doc subfolder, we could create a contributing file and link to the full docs in it.

The docs are here: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors

There are multiple paths that GitHub's UI will integrate these contribution guidelines on PRs for new users, or for other users if that document changes since their last contribution.

I think we should take advantage of it instead of inventing our own and being left to make it discoverable by our own too.

The idea with this style guide is to link it from the CONTRIBUTING.md file. That file needs some improvement, but that would be a different PR.

[echoix]

Perfect then

[neteler]

IMHO this should go into G8.4.0, no need to postpone. A nice document!

[wenzeslaus]

This is not published as part of the documentation, so I don't know where this will be visible in the release except release notes (which is nice), but we need this to be in the code for GSoC so we don't have to link a file in a PR.

[wenzeslaus]

Thanks for addressing all the issues.