Skip to content

migrate mintlify to docs.json + light bikeshedding#17591

Merged
aaazzam merged 3 commits intomainfrom
upgrade-mintlify-bikeshedding
Mar 27, 2025
Merged

migrate mintlify to docs.json + light bikeshedding#17591
aaazzam merged 3 commits intomainfrom
upgrade-mintlify-bikeshedding

Conversation

@aaazzam
Copy link
Collaborator

@aaazzam aaazzam commented Mar 25, 2025 •
edited
Loading

this PR

  • migrates to docs.json [https://mintlify.com/blog/refactoring-mint-json-into-docs-json]
    • this required a change to the mintlify-generate-api-schema function which triggered the test suite :(
  • removes docs versioning for now
    • current implementation more confusing than having no pointer
    • didn't version the API Ref / Examples / Integrations
      • just took you to a page with a link to go to the old docs.
  • ads iconography to 'getting started' section (bikeshedding)
  • removes "What's New in Prefect 3" from prime real estate (get started)
    • Prefect 3 is 80% of downloads

@aaazzam aaazzam requested a review from cicdw as a code owner March 25, 2025 03:54
@github-actions github-actions bot added the docs label Mar 25, 2025
@aaazzam aaazzam merged commit bd9d3f9 into main Mar 27, 2025
10 checks passed
@aaazzam aaazzam deleted the upgrade-mintlify-bikeshedding branch March 27, 2025 02:07
@rcash rcash mentioned this pull request Mar 28, 2025
Merged
4 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@cicdw cicdw Awaiting requested review from cicdw cicdw is a code owner

@desertaxle desertaxle Awaiting requested review from desertaxle desertaxle is a code owner

@zzstoatzz zzstoatzz Awaiting requested review from zzstoatzz zzstoatzz is a code owner

Assignees

No one assigned

Labels

docs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@aaazzam