(fix, docs): adapt all the middle content we have on the docs product

[dsinghvi]

We don't really cover much in the docs about Ferns docs product. This PR attempts to change that. The updated information architecture looks like this:

[github-actions]

🌿 Preview your docs: https://fern-preview-2b53468f-1744-48b4-902c-7e1c0a4aca52.docs.buildwithfern.com

[dannysheridan]

Getting Started

• Quickstart
• Project Structure (docs.yml, fern folder, fern.config.json, GitHub as CMS)
• Showcase

Building your Docs

• Styling
  -- Colors
  -- Fonts
  -- Light/Dark Mode
• Writing Content
  -- Using Markdown
  -- Using MDX/JSX
  -- Frontmatter
  -- Reusable Snippets
  -- Versioning
• Previewing
  -- Local Preview
  -- PR Previews
• API Reference
  -- Using OpenAPI
  -- Using Fern Definition
  -- Using MDX
  -- API Playground
  -- API Key Injection
• Scripts
  -- Custom CSS
  -- Custom JS
• Custom Domain
  -- Custom Subdomain
  -- Custom Subpath

Features

• Search by Algolia
• AI Chatbot
• Protect Your Docs
  -- Password-protected
  -- SSO
• Connecting Analytics

Components

• Built-in Components
• Custom Components

Comparing

• Fern to Mintlify
• Fern to ReadMe

[dannysheridan]

Opinion: the showcase cards should tell a user what to look for. (e.g., Primer -> Versioning)

[abvthecity]

Getting Started

• Quickstart
• Project Structure (docs.yml, fern folder, fern.config.json, GitHub as CMS)
• Showcase

Building your Docs

• Navigation
  • Sections
  • Tabs
  • Versions
  • API Reference
  • Search
• Customization
  • Theme (includes colors, light/dark mode)
  • Fonts
  • Layout (widths, heights, placement)
  • [pro] Header & Footer
  • [pro] Custom CSS
  • [pro] Custom JS
• Writing Content
  • Using Markdown
  • Using MDX/JSX
  • Frontmatter
  • Reusable Snippets
  • Versioning
• Previewing
  • Local Preview
  • PR Previews
• API Reference
  • Using OpenAPI
  • Using Fern Definition
  • Using MDX
  • API Playground
  • API Key Injection
• Custom Domain
  • Custom Subdomain
  • Custom Subpath

Features

• Search by Algolia
• AI Chatbot
• Protect Your Docs
  • Password-protected
  • SSO
• Connecting Analytics

Components

• Built-in Components
• Custom Components

Comparing

• Fern to Mintlify
• Fern to ReadMe

[dannysheridan]

Getting Started

• Quickstart
• Project Structure (docs.yml, fern folder, fern.config.json, GitHub as CMS)
• Showcase

Building your Docs

• Navigation
  • Sections
  • Tabs
  • Versions
  • API Reference
  • Search
• Customization
  • Theme (includes colors, light/dark mode)
  • Fonts
  • Layout (widths, heights, placement)
  • [pro] Header & Footer
  • [pro] Custom CSS
  • [pro] Custom JS
• Writing Content
  • Using Markdown
  • Using MDX/JSX
  • Frontmatter
  • Reusable Snippets
  • Versioning
• Previewing
  • Local Preview
  • PR Previews
• API Reference
  • Using OpenAPI
  • Using Fern Definition
  • Using MDX
  • API Playground
  • API Key Injection
• Custom Domain
  • Custom Subdomain
  • Custom Subpath

Features

• Search by Algolia
• AI Chatbot
• Protect Your Docs
  • Password-protected
  • SSO
• Analytics
  • Google Analytics
  • Segment
  • Mixpanel
  • PostHog
• Integrations
  • GitHub
  • Intercom
  • HubSpot
  • Slack
• SEO

Components

• Built-in Components
• Custom Components

Comparing

• Fern vs Mintlify
• Fern vs ReadMe