Create a pricing reference

[morekid]

As part of the Billing UI feature we need to create a location in the docs that can act as the most comprehensive reference about pricing and plans for users.

This will be linked from within the site billing page in the app and should provide in-page links for each plan, see design: Figma.

The most complete display of this information is currently at https://arcjet.com/pricing, but since the site is a marketing outlet we'd be better not rely on its content for these purposes.

[davidmytton]

since the site is a marketing outlet we'd be better not rely on its content for these purposes.

I'm not sure about this. Having multiple locations for pricing details seems like an easy way for them to get out of sync. Why don't we want to rely on the website?

[morekid]

Having multiple locations for pricing details seems like an easy way for them to get out of sync.

The syncing issue should be handled by having a common data source, I mentioned this here. When the billing ui lands we will have duplication of this info already in the website and app which is not ideal to maintain.

A website content is often subject to changes led by marketing reasons and as such might not be perceived as complete information nor particularly accountable for errors. It is more volatile than documentation.

[davidmytton]

Got it. In that case we can probably use the Stripe Product & Pricing APIs and use Stripe as the source for all the pricing data. It might also be possible to use Stripe Product Features to dynamically generate the pricing grids (at build time, not runtime).

[morekid]

Ok, moving the discussion on the underlying data in the Billing UI spec.

We can keep this task open if we agree we should create a long form pricing and feature reference in the docs.