docs: reuse

docs/examples/index.md

@@ -1,50 +1,12 @@
 # Code examples
 
-In this section you'll discover how to create code examples for _Testcontainers for Go_.
+In this section you'll discover how to create code examples for _Testcontainers for Go_, which are almost the same as Go modules, but without exporting any public API.
 
-## Interested in adding a new example?
-
-We have provided a command line tool to generate the scaffolding for the code of the example you are interested in. This tool will generate:
-
-- a Go module for the example, including:
-    - go.mod and go.sum files, including the current version of _Testcontainer for Go_.
-    - a Go package named after the example, in lowercase
-    - a Go file for the creation of the container, using a dedicated struct in which the image flag is set as Docker image.
-    - a Go test file for running a simple test for your container, consuming the above struct.
-    - a Makefile to run the tests in a consistent manner
-    - a tools.go file including the build tools (i.e. `gotestsum`) used to build/run the example.
-- a markdown file in the docs/examples directory including the snippets for both the creation of the container and a simple test.
-- a new Nav entry for the example in the docs site, adding it to the `mkdocs.yml` file located at the root directory of the project.
-- a GitHub workflow file in the .github/workflows directory to run the tests for the example.
-- an entry in Dependabot's configuration file, in order to receive dependency updates.
-
-### Command line flags
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| -name | string | Yes | Name of the example, use camel-case when needed. Only alphabetical characters are allowed. |
-| -image | string | Yes | Fully-qualified name of the Docker image to be used by the example (i.e. 'docker.io/org/project:tag') |
-| -title | string | No | A variant of the name supporting mixed casing (i.e. 'MongoDB'). Only alphabetical characters are allowed. |
-| -as-module | bool | No | If set, the example will be generated as a Go module, under the modules directory. Otherwise, it will be generated as a subdirectory of the examples directory. |
-
-### What is this tool not doing?
-
-- If the example name does not contain alphabetical characters, it will exit the generation.
-- If the example already exists, it will exit without updating the existing files.
-
-### How to run the tool
+Their main goal is to create shareable code snippets on how to use certain technology (e.g. a database, a web server), in order to explore its usage before converting the example module into a real Go module exposing a public API.
 
-From the [`modulegen` directory]({{repo_url}}/tree/main/modulegen), please run:
-
-```shell
-go run . --name ${NAME_OF_YOUR_EXAMPLE} --image "${REGISTRY}/${EXAMPLE}:${TAG}" --title ${TITLE_OF_YOUR_EXAMPLE}
-```
-
-or for creating a Go module:
+## Interested in adding a new example?
 
-```shell
-go run . --name ${NAME_OF_YOUR_EXAMPLE} --image "${REGISTRY}/${EXAMPLE}:${TAG}" --title ${TITLE_OF_YOUR_EXAMPLE} --as-module
-```
+Please refer to the documentation of the code generation tool [here](../modules/index.md).
 
 ## Update Go dependencies in the examples