Skip to content

Commit

Permalink
Improve Documentation for Custom Starters in kedro new (kedro-org#2618)
Browse files Browse the repository at this point in the history
Signed-off-by: Dominik <dominikzalewski97@gmail.com>
  • Loading branch information
doxenix committed Apr 2, 2024
1 parent b77de75 commit 160bf17
Showing 1 changed file with 14 additions and 2 deletions.
16 changes: 14 additions & 2 deletions docs/source/starters/starters.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,13 @@ kedro new --starter=<path-to-starter>
```

```{note}
`path-to-starter` could be a local directory or a VCS repository, as long as [Cookiecutter](https://cookiecutter.readthedocs.io/en/stable/usage.html) supports it.
`path-to-starter` could be the path to a local directory, a URL to a remote VCS repository supported by `cookiecutter` or one of the aliases listed in ``kedro starter list``.
```

If you want to use `--starter` as remote VCS repository, run:

```bash
kedro new --starter git+https://github.com/kedro-org/kedro-starters.git --directory spaceflights-pandas
```

## Starter aliases
Expand Down Expand Up @@ -79,5 +85,11 @@ kedro new --config=my_kedro_project.yml --starter=spaceflights-pandas

This option is useful when the starter requires more configuration than the default mode requires.

## Create a starter
## Custom starter
You can build your own starters for reuse within a project or team, as described in the [how to create a Kedro starter](../starters/create_a_starter.md) documentation.

To create project with created custom starter template, run:

```bash
kedro new --starter=<path-to-starter> --directory <directory>
```

0 comments on commit 160bf17

Please sign in to comment.