Docs: add adapter heading for configuration docs (#3842)

* Docs: add adapter heading for configuration docs

* docs: add adapter example, rework doc links

* chore: changeset

.changeset/funny-masks-yawn.md

@@ -0,0 +1,5 @@
+---
+'astro': patch
+---
+
+Docs: add complete "adapter" configuration reference

packages/astro/src/@types/astro.ts

@@ -585,11 +585,22 @@ export interface AstroUserConfig {
 	};
 
 	/**
-	 * @name adapter
+	 * @docs
-	 * @type {AstroIntegration}
+	 * @kind heading
-	 * @default `undefined`
+	 * @name Adapter
 	 * @description
-	 * Add an adapter to build for SSR (server-side rendering). An adapter makes it easy to connect a deployed Astro app to a hosting provider or runtime environment.
+	 * 
+	 * Deploy to your favorite server, serverless, or edge host with build adapters. Import one of our first-party adapters for [Netlify](https://docs.astro.build/en/guides/deploy/netlify/#adapter-for-ssredge), [Vercel](https://docs.astro.build/en/guides/deploy/vercel/#adapter-for-ssr), and more to engage Astro SSR.
+	 * 
+	 * [See our Server-side Rendering guide](https://docs.astro.build/en/guides/server-side-rendering/) for more on SSR, and [our deployment guides](https://docs.astro.build/en/guides/deploy/) for a complete list of hosts.
+	 * 
+	 * ```js
+	 * import netlify from '@astrojs/netlify/functions';
+	 * {
+	 *   // Example: Build for Netlify serverless deployment
+	 * 	 adapter: netlify(),
+	 * }
+	 * ```
 	 */
 	adapter?: AstroIntegration;