Skip to content

Commit

Permalink
feat(docs): small docs and website revamp + new migrations section (#434
Browse files Browse the repository at this point in the history 
)
  • Loading branch information
@anna-geller
anna-geller authored Aug 14, 2023
1 parent f51806f commit 4a977e2
Show file tree
Hide file tree
Showing 19 changed files with 275 additions and 189 deletions.
1 change: 1 addition & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
Expand Up @@ -34,3 +34,4 @@ node_modules
.env
dist
.obsidian/**/*
package-lock.json
2 changes: 1 addition & 1 deletion components/docs/RecursiveNavSidebar.vue
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<li class="depth-1">
<NuxtLink href="/docs" class="bold" :class="activeSlug === '/docs' || activeSlug === '/docs/' ? 'active' : ''"
>
👁️‍🗨️ Overview
👋 Welcome to Kestra
</NuxtLink>
</li>
</ul>
Expand Down
4 changes: 2 additions & 2 deletions components/features/Build.vue
View file
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><CalendarStartOutline /></span>
<h4 class="card-title">Event-Based</h4>
<h4 class="card-title">Real-Time Events</h4>
<p class="card-text">Flow execution based on events from the core or plugins, such as the result of other flows in real-time, detection of files from SFTP or Google Cloud Storage, or results of an SQL query.</p>
</div>
</div>
Expand All @@ -36,7 +36,7 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><ClockStart /></span>
<h4 class="card-title">Infinity of triggers</h4>
<h4 class="card-title">Event-driven Triggers</h4>
<p class="card-text">Endless possibilities to start a flow through API, using a webhook, waiting for a trigger, or simply starting directly from the Web UI.</p>
</div>
</div>
Expand Down
34 changes: 17 additions & 17 deletions components/features/Main.vue
View file
Original file line number Diff line number Diff line change
@@ -1,38 +1,41 @@
<template>
<div class="container">
<Section
title="Finally an orchestrator that get it right"
subtitle="The Ultimate Orchestrator for Reliable Data Workflows"
title="Finally, no dependency conflicts. It just works!"
subtitle="Add new workflows in minutes. No ops required."
>
<div class="row mb-5">
<div class="col-md-6" data-aos="fade-right">
<img class="img-fluid" src="/landing/features/declarative.svg" alt="A YAML sample of code for declarative language and construction of Kestra's flows" />
</div>
<div class="col-md-6 p-5" data-aos="fade-right">
<h3>Declarative code for creating flows</h3>
<h3>API-first design with declarative workflow definition</h3>
<ul>
<li>
<strong>Easy Workflow Creation:</strong> Build custom workflows quickly and with minimal coding <NuxtLink href="/features/declarative-data-orchestration">using YAML</NuxtLink>.
<strong>Strong typing and autocompletion:</strong> iterate quickly when adding new flows, triggers and tasks. If something is incorrect in your workflow definition, you will know in advance thanks to the built-in syntax validation.
</li>
<li>
<strong>Intuitive User Interface:</strong> Visualize and manipulate workflow directly from the UI.
<strong>Support for data-mesh:</strong> thanks to the thanks to the simple <NuxtLink href="/features/declarative-data-orchestration"> YAML interface</NuxtLink>, built-in documentation and blueprints, domain experts can build their own workflows, too.
</li>
<li>
<strong>Intuitive UI built not only for engineers:</strong> when you add workflows directly from the UI, the live-updating topology view helps you see dependencies between processes, systems and tasks.
</li>
</ul>
</div>
</div>

<div class="row mb-5">
<div class="col-md-6 p-5 order-1 order-md-0" data-aos="fade-left">
<h3>Quick and Easy Workflow Building</h3>
<h3>Iterate faster without the overhead of CI/CD</h3>
<ul>
<li>
<strong>Optimized Task Management:</strong> Seamless task execution in a variety of ways including sequential, parallel, and conditional execution.
<strong>Less time spent babysitting orchestration code:</strong> Seamlessly configure your tasks to run sequentially, in parallel or only based on a specific condition or presence of events without having to navigate convoluted orchestration code bases.
</li>
<li>
<strong>Intuitive Orchestration:</strong> Easily manage task dependencies and ensure proper execution order.
<strong>Intuitive dependency management:</strong> Easily manage task dependencies — defining proper execution order is as simple as adding a list of tasks in the order you want them to be executed.
</li>
<li>
<strong>Flexible Workflow Control:</strong> Full control of workflow orchestration, ensuring tasks are running efficiently.
<strong>Built-in documentation and blueprints:</strong> No need to navigate bulky documentation to figure out the right task or trigger properties — they are available right next to your code editor.
</li>
</ul>
</div>
Expand All @@ -46,13 +49,13 @@
<img class="img-fluid" src="/landing/features/flowable.svg" alt="A list of flowable tasks such as sequential, parallel, loop, switch, pause and template" />
</div>
<div class="col-md-6 p-5" data-aos="fade-right">
<h3>Flexible Workflow Scheduling</h3>
<h3>Flexible Event-Driven Workflow Execution</h3>
<ul>
<li>
<strong>Time-based scheduling:</strong> Workflows run automatically at specific times, such as daily, weekly, or monthly for a regular execution without the need for manual intervention.
<strong>Time-based scheduling:</strong> Workflows run automatically at specific times, such as daily, weekly, or monthly without the need for manual intervention or inspecting crontabs.
</li>
<li>
<strong>Event-based scheduling:</strong> Trigger workflows to run automatically in response to events, such as the arrival of new data or the completion of other workflows. Automate workflow executions based on real-time events.
<strong>Event-based orchestration:</strong> Automate workflow executions based on real-time events. Trigger workflows to run automatically in response to events, such as the arrival of new data in a database, file detection in your cloud storage bucket, new message in a message queue, or the completion of other workflows.
</li>
</ul>
</div>
Expand All @@ -63,13 +66,10 @@
<h3>Execute and Monitor in Real Time</h3>
<ul>
<li>
<strong>Real-time Workflow Monitoring:</strong> Progress tracking of workflows and individual tasks in real-time.
</li>
<li>
<strong>Actionable Insights:</strong> insights of workflows performances using built-in logs and metrics.
<strong>Real-time Workflow Monitoring:</strong> Progress tracking of workflows and individual tasks in real-time. Troubleshoot failure by replaying failed tasks or doing a full-text search of the workflow execution logs.
</li>
<li>
<strong>Intuitive User Interface:</strong> Quick Workflow execution and view of the state of tasks directly from the UI.
<strong>Actionable Insights:</strong> you can build custom dashboards to track workflow performance using built-in outputs and metrics. Thanks to a standardized format that Kestra uses, all your Kestra metrics can be visualized in Grafana or Kibana.
</li>
</ul>
</div>
Expand Down
6 changes: 3 additions & 3 deletions components/features/Ships.vue
View file
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<template>
<div class="container">
<Section
title="Save on time, stress, and development costs."
subtitle="FEATURES"
baseline="Save on time, stress, and development costs."
title="Save time and development costs."
subtitle="Simplicity scales, complexity fails"
baseline="Less time spent writing boilerplate orchestration code, more time for what matters to your business"
>

<div class="row card-group mb-2">
Expand Down
2 changes: 1 addition & 1 deletion components/features/declaratives/Empower.vue
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@

<div class="row mb-5">
<div class="col-md-6 p-5 order-1 order-md-0" data-aos="fade-left">
<h3>Empower Your Data Team with Declarative Orchestration</h3>
<h3>Empower Your Team with Declarative Orchestration</h3>
<ul>
<li>
<strong>Accelerate Time to Value:</strong> Declarative orchestration modernized the creation and maintenance of data pipelines, enabling data teams to deliver results faster and more efficiently.
Expand Down
26 changes: 13 additions & 13 deletions components/home/Features.vue
View file
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<template>
<div class="container">
<Section subtitle="Stand Out with Kestra's Exclusive Features" title="Enhanced Workflow Efficiency">
<Section subtitle="Simplicity scales, complexity fails" title="Simple, Scalable and Fast Orchestration">
<div class="row card-group mb-2">
<div class="col-md-4 mb-4">
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><CalculatorVariantOutline /></span>
<h4 class="card-title">Powerful Data Processing</h4>
<p class="card-text">Execute complex data processing without the need for extensive coding skills</p>
<h4 class="card-title">Declarative and imperative workflows</h4>
<p class="card-text">Decide based on your use case how declarative or imperative you want your workflows to be. Write your business logic in Python, R, Node.js or Julia, and orchestrate it declaratively.</p>
</div>
</div>
</div>
Expand All @@ -16,8 +16,8 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><Lan /></span>
<h4 class="card-title">Robust Scheduling and Orchestration</h4>
<p class="card-text">Manage data workflows with flexible scheduling options and orchestrate all types of workflows</p>
<h4 class="card-title">Scalable architecture as a foundation</h4>
<p class="card-text">Kestra's architecture is built on top of proven and time-tested technologies including Postgres, Kafka and Elasticsearch.</p>
</div>
</div>
</div>
Expand All @@ -26,8 +26,8 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><GoogleCirclesExtended /></span>
<h4 class="card-title">Extensive Library of plugins</h4>
<p class="card-text">Integrate with various systems and services from 3rd party sources or build your own plugins</p>
<h4 class="card-title">Rich plugin ecosystem</h4>
<p class="card-text">Integrate with any source system, database or data tool, and build your own plugins and blueprints to eliminate boilerplate code and automate repetitive tasks.</p>
</div>
</div>
</div>
Expand All @@ -36,8 +36,8 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><OpenInApp /></span>
<h4 class="card-title">Increase Productivity and Efficiency</h4>
<p class="card-text">Create and manage your workflows using the low code editor or write them <NuxtLink href="/features/declarative-data-orchestration">in YAML</NuxtLink></p>
<h4 class="card-title">Fast development cycles</h4>
<p class="card-text">Create flows in a simple <NuxtLink href="/features/declarative-data-orchestration">declarative YAML config</NuxtLink> directly from the UI with autocompletion, syntax validation and built-in documentation. Or use our official VS Code extension to integrate your workflows with Git and CI/CD systems.</p>
</div>
</div>
</div>
Expand All @@ -46,8 +46,8 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><RefreshAuto /></span>
<h4 class="card-title">Reliable Automated Production</h4>
<p class="card-text">Eliminate bottlenecks with Kestra's reliable and automated workflows</p>
<h4 class="card-title">API-first design</h4>
<p class="card-text">Because every action in Kestra is API-driven, there are no limits to what you can automate, from changing flow and task configuration using internal tools, to triggering, adding or modifying workflows in any way you can imagine.</p>
</div>
</div>
</div>
Expand All @@ -56,8 +56,8 @@
<div class="card" data-aos="zoom-in">
<div class="card-body">
<span class="card-icon"><CloudOutline /></span>
<h4 class="card-title">Deploy anywhere with no point of failure</h4>
<p class="card-text">From only a few executions to millions, without hassle, in the cloud or on-premise</p>
<h4 class="card-title">Deploy anywhere with no single point of failure</h4>
<p class="card-text">Scale your data platform from only a few executions to millions, without hassle. You can deploy Kestra on-prem and on Cloud using our official Helm chart, Terraform provider, or a manual installation using a single binary. </p>
</div>
</div>
</div>
Expand Down
6 changes: 3 additions & 3 deletions components/home/How.vue
View file
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<template>
<div class="container">
<Section
title="Performant and Scalable Data Operations"
subtitle="Master Data Workflows"
title="Scheduled and Event-Driven Data Operations"
subtitle="Simpler and Faster Data Workflows"
>
<div class="row mb-5">
<div class="col-md-6 p-5" data-aos="fade-right">
<p class="overline">Step 1</p>
<h3>Define your workflows</h3>
<p>
Declare all <NuxtLink href="/features/declarative-data-orchestration">your flows in Yaml</NuxtLink>, specify all tasks that need to be executed, the input and output data, and any dependencies between steps.
Declare all <NuxtLink href="/features/declarative-data-orchestration">your flows in YAML</NuxtLink>, specify all tasks that need to be executed, the input and output data, and any dependencies between steps.
</p>
</div>
<div class="col-md-6" data-aos="fade-right">
Expand Down
10 changes: 5 additions & 5 deletions components/home/UI.vue
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<Section
class="dark"
subtitle="All-Inclusive Dashboard"
title="Empower Developers with a Comprehensive, User-Friendly Interface"
title="Empower Your Team with a Comprehensive, User-Friendly Orchestration Interface"
>
<div class="row mb-5">
<div class="col-lg-8">
Expand All @@ -19,31 +19,31 @@
<div class="card-body">
<p class="mb-0">
<span class="card-icon rounded-5"><WrenchOutline /></span>
Built-in low code editor for your flows
Built-in editor to define flows, SQL queries and custom scripts
</p>
</div>
</div>
<div class="card" @click="active = 2" :class="{active: active === 2}" data-aos="fade-left" data-aos-delay="50">
<div class="card-body">
<p class="mb-0">
<span class="card-icon rounded-5"><ChartTimelineVariant /></span>
Execute and monitor directly from the user interface
Dashboards to monitor your system's health
</p>
</div>
</div>
<div class="card" @click="active = 3" :class="{active: active === 3}" data-aos="fade-left" data-aos-delay="100">
<div class="card-body">
<p class="mb-0">
<span class="card-icon rounded-5"><ApplicationBracketsOutline /></span>
Simple declarative language editor
Simple declarative editor with live-updating DAG view
</p>
</div>
</div>
<div class="card" @click="active = 4" :class="{active: active === 4}" data-aos="fade-left" data-aos-delay="150">
<div class="card-body">
<p class="mb-0">
<span class="card-icon rounded-5"><ViewDashboardVariantOutline /></span>
Complete and comprehensive dashboard
Language-agnostic interface for scheduled and event-driven flows
</p>
</div>
</div>
Expand Down
Loading

1 comment on commit 4a977e2

@vercel
Copy link

@vercel vercel bot commented on 4a977e2 Aug 14, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

kestra-io – ./

kestra-io-git-main-kestra.vercel.app
kestra-io-kestra.vercel.app
kestra-io.vercel.app

Please sign in to comment.