Getting Started - Tutorial Content

[tjwald]

I am trying to train many people in my group to adopt Aspire, and have the pay-for-play experience:

1. Adding Aspire to an existing Application
2. Create custom resource
3. Publishing
4. E2E tests

I want them to learn these skills one at a time, and only when they need to. To do so, I would love to just share a link to the website for each topic during training.

Adding Aspire to an existing Application

I think that migration guides from docker-compose.yaml, helm charts, etc. are in place.

Custom Resource

Currently, the docs do not contain easy to follow Custom Resource creation, with a "real" resource.

The only doc showing what a custom resource looks like is: Resource Examples.

This doc isn't a step by step guide on how to create a resource.

There should be a Create Your First Custom Resource [Tutorial] right next to Create Your First App.

Publishing

I am interested in k8s helm charts, docker build && push to registry in CI.

I know that k8s is going to be rewritten.

The docker build && push in CI is a really cool use case for Aspire as it makes it so there is only one place in the code that knows where all the docker files (or dynamically created docker files) exist, and how to build them.

But I have no idea how to do this.

E2E testing

There are currently no docs for how to use Aspire for E2E testing using the testing package, including how to wire this up in CI.

Thanks! Love the Website :)

[IEvangelist]

Hey @tjwald - I updated the description of this issue to have a numbered list (probably should be a task list), but for 1 - I wanted to solicit your thoughts on this PR #67. And for 4 - we migrated over this content:

• https://aspire.dev/testing/overview/
• https://aspire.dev/testing/write-your-first-test/
• https://aspire.dev/testing/manage-app-host/
• https://aspire.dev/testing/accessing-resources/

[tjwald]

The testing docs look great! Regarding xUnit - is this using xunit.v3? There were a lot of breaking changes...

[tjwald]

Is there a way to view the new content in that PR in a website? It's hard to follow otherwise.
On the face of it, the PR summary looks good and sounds like a great resource!