carvel-dev / carvel-dev/ytt

ytt guides & examples

Open
#314 1 comment 1 reaction 1 assignee Claimed by @cari-lynn View on GitHub
Epic
Dominant language
Go
Stars
1.9k
Forks
167
PR merge metrics
No merged PRs in 30d

Description

## Problem Statement

The current ytt documentation goes in depth listing what features are available in ytt which is acting like a reference. However, it lacks in explaining how these various features can be applied in real-life scenarios which leaves new ytt users to figure out how to use ytt to solve their problems on their own. This not only takes time for new users to ramp up in ytt but also leaves them feeling less confident whether they are using ytt the “best way” or the intended way it was designed to be used.

Many ytt users have pointed out that the interactive playground is a great place to learn, however, it could be hard to find the topic the users are interested in and the name of the topics are not descriptive enough to help finding the right example they are looking for.

## First Increment (MVP)

Research and compile a list of 5 or 6 use cases for guides. This list will be updated as we research and get feedback.

- [x] [Getting started with ytt from plain yaml](https://github.com/vmware-tanzu/carvel-ytt/issues/492)
- [x] [When I would use library file, private library, or a data values file?](https://github.com/vmware-tanzu/carvel-ytt/issues/318)
- [x] e.g. #392
- [x] e.g. [#carvel@2021-06-02T14:14Z](https://kubernetes.slack.com/archives/CH8KCCKA5/p1622643291252400)
- [ ] #649
- [ ] #650
- [ ] #651

Prioritizing content over presentation, create guides and code examples for the use cases.

Collect feedback on the guides early and incorporate it into the following guides.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.