feat: better example generation, add parameter definitions

[RohinBhargava]

Short description of the changes made

• Adds parameters to example parsing
• Simplifies the logic for Examples and makes it clear where to plumb snippets and merge -> now we parse redoc, x-fern-examples and oai examples independently, falling back to an autogenerated example if none is found
• Fixes issues where null checking was short circuiting

What was the motivation & context behind this PR?

• Customer feedback

How has this PR been tested?

• snapshots and unit tests

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
rbac.ferndocs.com	❌ Failed (Inspect)		Jan 15, 2025 1:33am

1 Skipped Deployment

Name	Status	Preview	Updated (UTC)
fern-shell	⬜️ Ignored (Inspect)		Jan 15, 2025 1:33am

[github-actions]

📦 Next.js Bundle Analysis for fern-platform-monorepo

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

[github-actions]

PR Preview

• angellist.docs.withchima.com
• api-docs.codecombat.com
• api.babelstreet.com
• api.labelstud.io
• api.navipartner.com
• api.qdrant.tech
• apidocs.polytomic.com
• column.docs.withchima.com
• dev.documentation.sayari.com
• dev.hume.ai
• developer.artlist.io
• developer.balkan.id
• developer.devrev.ai
• developer.ideogram.ai
• developer.nibtravelinsurance.com
• developer.projectmanager.com
• developer.yocobeta.co.za
• developers.ada.cx
• developers.awork.com
• developers.beehiiv.com
• developers.duve.com
• developers.gappify.com
• developers.upwardli.com
• docs-beta.projectmanager.com
• docs-next.scoutos.com
• docs.aiaplatform.com.au
• docs.airtop.ai
• docs.amniscient.com
• docs.anterior.com
• docs.argolabs.ai
• docs.athenaintel.com
• docs.benchify.com
• docs.boundaryml.com
• docs.brightmove.com
• docs.bytebot.ai
• docs.cable.tech
• docs.cartesia.ai
• docs.coactive.ai
• docs.cohere.com
• docs.conductorquantum.com
• docs.credal.ai
• docs.darwinbio.io
• docs.darwincloud.xyz
• docs.data.aviato.co
• docs.dataglade.com
• docs.deeptune.com
• docs.edp.codeclimate.com
• docs.edp.dev
• docs.eyelevel.ai
• docs.fileforge.com
• docs.flagright.com
• docs.fluidstack.io
• docs.frankieone.com
• docs.getanalog.ai
• docs.getkard.com
• docs.getscorecard.ai
• docs.givechariot.com
• docs.goldenbasis.com
• docs.hellodata.ai
• docs.impiloplatform.com
• docs.instabase.com
• docs.joincandidhealth.com
• docs.kota.io
• docs.letta.com
• docs.mavenagi.com
• docs.mercoa.com
• docs.monite.com
• docs.multion.ai
• docs.nominal.io
• docs.ntropy.com
• docs.openledger.com
• docs.paradex.trade
• docs.payos.money
• docs.pier-finance.com
• docs.predictionguard.com
• docs.privategpt.dev
• docs.propexo.com
• docs.qlty.ai
• docs.qlty.sh
• docs.qlty.us
• docs.reka.ai
• docs.revert.dev
• docs.rightbrain.ai
• docs.schematichq.com
• docs.scorecard.io
• docs.scoutos.com
• docs.scrapybara.com
• docs.sphinxbio.com
• docs.stack-auth.com
• docs.staging.paradex.trade
• docs.subconscious.ai
• docs.superagent.sh
• docs.syndicate.io
• docs.termina.ai
• docs.trykeet.com
• docs.trypinnacle.app
• docs.upshift.dev
• docs.usebridge.com
• docs.vellum.ai
• docs.withabound.com
• docs.withchima.com
• documentation.babelstreet.com
• documentation.sayari.com
• fern.assemblyai.com
• fern.ssoready.com
• gusto.docs.withchima.com
• handbook.codeclimate.com
• help.getzep.com
• plantstore.dev
• reference.flatfile.com
• rippling.docs.withchima.com
• secure.docs.propexo.com
• www.intern.mavenagi.com
• www.plantstore.dev

[github-actions]

Playwright test results

 96 passed
 3 flaky
 2 skipped

Details

 101 tests across 9 suites
 1 minute, 15 seconds
 9f24889

Flaky tests

chromium › smoke/favicon.spec.ts › Check if favicon exists and URL does not return 404 for api.qdrant.tech
chromium › smoke/favicon.spec.ts › Check if favicon exists and URL does not return 404 for developers.gappify.com
chromium › smoke/favicon.spec.ts › Check if favicon exists and URL does not return 404 for docs.darwincloud.xyz

Skipped tests

chromium › posthog.spec.ts › Posthog loads successfully
chromium › websockets/websocket.spec.ts › websocket test

[dsinghvi]

Added comments around quality of life/code legibility