docs: add `/examples` folder

[cyclotruc]

Create an examples/ folder containing practical examples demonstrating various ways to use both the CLI and Python package. This will significantly improve the contributor experience and make the project more accessible to new users.
Motivation

New users need concrete examples to understand how to use the tool effectively
AI agents would benefit from clear usage patterns and examples
Reduces the learning curve for contributors
Complements existing documentation with hands-on examples

Examples should be self-contained and runnable
Include comments explaining key concepts
Consider adding expected output for CLI examples
Examples should cover both basic and advanced use cases

[filipchristiansen]

Regarding documentation, we should also give an example for the "url trick" other than with GitHub, e.g., GitLab, Bitbucket, etc.