Choreography is an attempt to document events from a specific Microservice. In the modern world, with Event Driven Architectures becoming the norm, document events and providing Discoverability for those events is challenging.

I picture it as a Swagger-UI for events in your Microservice. It allows you to add automatic documentation and provide discoverability for those events that service produces, and where those events go.

If you use Asp.NET Core applications, using strongly typed events this is ideal for your.

https://www.nuget.org/packages/Choreography.AspNetCore.UI

Add to your Startup.cs file to ConfigureServices method the Descriptor. The descriptor reads all non-abstract classes that are assignable from the specified type. Make sure those classes have a default constructor.

public void ConfigureServices(IServiceCollection services)
{

    services.AddControllers();
    services.AddChoreographyDescriptor<IEvent>();
}

Add to your Startup.cs file to Configure the UI configuration.

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ... other app config
    app.UseChoreographyUI(options =>
    {
        options.HeadContent = "Choreography UI";
        options.MessageBroker = "choreography.mybroker.com";
        options.TopicName = "choreography-topic";
        options.DocumentTitle = "Choreography";
    });
}

As you can see, you can display custom information to customize your page, also output the Broker and Topic/Queue your Microservice produces events to.

After starting your service, just go to the URL to see the UI:

https://{SERVICE_URL}/choreography/index.html

You shall see the UI like below.

• UI still need some usability love

This project still experimental, I want community feedback, but here it goes what I'm planning to do: