docs: restructuralize examples - move all of them into a dedicated dir

[pesekon2]

Create directory docs/examples and move the following directories inside:

• docs/gui
• docs/notebooks
• docs/python
• docs/raster
• docs/vector

[echoix]

I'm just including Markus as we are finishing off a big documentation transition, and thus to make sure it is covered correctly and accounted for in the transition (for work possibly already done or tested without this change)

[pesekon2]

I'm just including Markus as we are finishing off a big documentation transition, and thus to make sure it is covered correctly and accounted for in the transition (for work possibly already done or tested without this change)

The commit in talk is the already-merged ab90c5e, right? I have merged main into the PR to be up-to-date and solved some minimal conflicts popping up.

[neteler]

The commit in talk is the already-merged ab90c5e, right?

That's correct.

I have merged main into the PR to be up-to-date and solved some minimal conflicts popping up.

Great, thanks for taking care of the conflicts.

[neteler]

There is still a linting issue:

MARKDOWN
  2024-12-19 09:43:49 [INFO]   Linting MARKDOWN items...
  Error: -19 09:43:52 [ERROR]   Found errors when linting MARKDOWN. Exit code: 1.
  2024-12-19 09:43:52 [INFO]   Stderr contents for MARKDOWN:
  ------
  /github/workspace/doc/examples/notebooks/README.md:8:81 MD013/line-length Line length [Expected: 80; Actual: 91]

[pesekon2]

There is still a linting issue:

MARKDOWN
  2024-12-19 09:43:49 [INFO]   Linting MARKDOWN items...
  Error: -19 09:43:52 [ERROR]   Found errors when linting MARKDOWN. Exit code: 1.
  2024-12-19 09:43:52 [INFO]   Stderr contents for MARKDOWN:
  ------
  /github/workspace/doc/examples/notebooks/README.md:8:81 MD013/line-length Line length [Expected: 80; Actual: 91]

Yes. The only reason it pops up now is that the original file contained it and it was moved now (without edits). It is not introduced by this PR, it is just that the linter finally got to check the file. I guess it should therefore be fixed in a separate PR (this one should not modify files unless necessary) -> I'll prepare a chore one that should be merged before this one.

[echoix]

The PR with the line length fix was merged, so there's a small conflict here to solve (copy the changed file again here)

[pesekon2]

The PR with the line length fix was merged, so there's a small conflict here to solve (copy the changed file again here)

Merged into the PR. Markdown issues solved. But there are still issues with some Python code - some of the moved Python example modules have their description too long.

./doc/examples/python/m.distance.py:28:89: E501 line too long (103 > 88 characters)
# % description: If the projection is latitude-longitude, this distance is measured along the geodesic.
                                                                                        ^

Is there any way to handle this? I found many places like this throughout the repository but none of them seemed to have to deal with this so far. They are just ticking ticking ticking timebombs waiting for a new commit to activate them (all of them seemed to be modified before the linter was introduced).

[echoix]

The PR with the line length fix was merged, so there's a small conflict here to solve (copy the changed file again here)

Merged into the PR. Markdown issues solved. But there are still issues with some Python code - some of the moved Python example modules have their description too long.

./doc/examples/python/m.distance.py:28:89: E501 line too long (103 > 88 characters)

# % description: If the projection is latitude-longitude, this distance is measured along the geodesic.

                                                                                        ^

Is there any way to handle this? I found many places like this throughout the repository but none of them seemed to have to deal with this so far. They are just ticking ticking ticking timebombs waiting for a new commit to activate them (all of them seemed to be modified before the linter was introduced).

https://github.com/OSGeo/grass/blob/main/.flake8 ?