search

kestra-io / docs

Documentation for Kestra — an event-driven, language-agnostic orchestration and scheduling platform to manage millions of workflows declaratively in code.
https://kestra.io/docs
68 stars 60 forks source link

Improve the configuration guide #1546

Open anna-geller opened 2 months ago

anna-geller commented 2 months ago

Description

Kestra is highly configurable. As a result, there's a lot you can configure, to the extent that the Configuration docs page has become overwhelmingly complex.

We should explore some friendlier designs for configuration to consolidate configuration per product/service/user journey step e.g.

  1. Initial Setup — all configuration pages that are only required during the first setup, like configuring DB and storage backend, secrets
  2. Feature Flags e.g. enabling specific features or keeping deprecated features
  3. Governance — Variables, Plugins, Usage (telemetry) etc = things that can be changed anytime

@wrussell1999 I'm aware this would mean adding nesting 😢 but seeing where we are already (there will be more configuration in the future!), breaking this down seems inevitable.

wrussell1999 commented 2 months ago

I think nesting is a positive thing here. There's a point where it makes sense and we're at that point now!