[Freshness Policy GA] api docs

[anuthebananu]

Summary & Motivation

• Adds API docs for FreshnessPolicy
• Adds @public annotation to FreshnessPolicy class
• Moves docstrings from freshness subclasses to their corresponding static constructors
• Fixes a small bug in mdx generator that did not render newlines correctly in the api docs

How I Tested These Changes

local docs site

Changelog

Insert changelog entry or delete this section.

[anuthebananu]

• [Freshness Policy GA] api docs #32665 👈 (View in Graphite)
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Deploy preview for dagster-docs ready!

Preview available at https://dagster-docs-9mvkutpyg-elementl.vercel.app
https://10-28-freshness-api-docs.archive.dagster-docs.io

Direct link to changed pages:

[neverett]

@anuthebananu I'm seeing this docs build error:

[2025-10-29T14:24:42Z] /workdir/python_modules/dagster/dagster/_core/definitions/freshness.py:docstring of dagster._core.definitions.freshness.FreshnessPolicy.time_window:1: WARNING: duplicate object description of dagster.FreshnessPolicy.time_window, other instance in sections/api/apidocs/dagster/assets, use :no-index: for one of them
[2025-10-29T14:24:42Z] /workdir/python_modules/dagster/dagster/_core/definitions/freshness.py:docstring of dagster._core.definitions.freshness.FreshnessPolicy.cron:1: WARNING: duplicate object description of dagster.FreshnessPolicy.cron, other instance in sections/api/apidocs/dagster/assets, use :no-index: for one of them

Are these methods referenced multiple times in assets.rst or defined multiple times in the source code?

[anuthebananu]

I've only added to RST in a single file (docs/sphinx/sections/api/apidocs/dagster/assets.rst) in this PR

[anuthebananu]

i also added @public annotations to the FreshnessPolicy class and the two methods in the error (cron and time_window) - maybe I don't need the methods annotated?

[anuthebananu]

Removing the annotation from the methods seems to have fixed things

[anuthebananu]

Merge activity

• Oct 29, 3:57 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Oct 29, 3:58 PM UTC: @anuthebananu merged this pull request with Graphite.