docs/tutorials/_index.md

<!--
  ~ Licensed to the Apache Software Foundation (ASF) under one
  ~ or more contributor license agreements.  See the NOTICE file
  ~ distributed with this work for additional information
  ~ regarding copyright ownership.  The ASF licenses this file
  ~ to you under the Apache License, Version 2.0 (the
  ~ "License"); you may not use this file except in compliance
  ~ with the License.  You may obtain a copy of the License at
  ~
  ~   http://www.apache.org/licenses/LICENSE-2.0
  ~
  ~ Unless required by applicable law or agreed to in writing,
  ~ software distributed under the License is distributed on an
  ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  ~ KIND, either express or implied.  See the License for the
  ~ specific language governing permissions and limitations
  ~ under the License.
-->

---
title: Tutorials
description: Step-by-step guides for building workflows and applications with Texera.
weight: 40
---

{{% pageinfo %}}
This section provides complete, end-to-end tutorials that guide you through realistic Texera use cases — from building simple workflows to creating complex data analytics pipelines.
{{% /pageinfo %}}

Texera tutorials help you learn by doing.  
Each tutorial walks through a **realistic workflow scenario**, showing how to use Texera’s visual interface, operators, and execution engine to build and run data analytics applications.

---

## 🎯 What to Expect

The tutorials in this section will help you:

- Understand Texera’s **workflow-based design** step by step.
- Learn how to **connect operators**, configure parameters, and visualize results.
- Explore **practical data use cases**, such as text processing, joining datasets, and real-time analysis.
- Get comfortable with **extending Texera** by creating or modifying operators.

---

## 🧱 Structure

Each tutorial consists of:

1. **Goal Overview** – what you’ll build and what problem it solves.
2. **Step-by-Step Instructions** – detailed actions to complete the workflow.
3. **Key Takeaways** – concepts and Texera features you’ll learn.
4. **Next Steps** – related tutorials or examples to explore further.

---

## 🧭 Getting Started

If you’re new to Texera, start with the [Getting Started](/docs/getting-started/) guide to set up your local environment.  
Once Texera is running, return here to begin working through the tutorials in order.

---

## 📚 Available Tutorials

This section will include multiple tutorials, such as:

- Building your first workflow
- Exploring data transformation operators
- Working with visualization tools
- Combining multiple datasets
- Extending Texera with custom operators

Each tutorial will include screenshots, sample data, and workflow files you can download and import into your Texera instance.

---

## 💡 Want to Contribute a Tutorial?

If you’ve built a useful workflow or want to help new users learn Texera, you can contribute your own tutorial:
1. Create a Markdown page under `content/docs/tutorials/`.
2. Include any relevant `.json` workflow files or sample datasets.
3. Submit a pull request following our [Contribution Guidelines](/docs/contribution-guidelines/).

---

Texera tutorials are designed to help you go from **understanding concepts** to **building complete solutions** — one workflow at a time.