Docs: netlify adapter site requirement (#2996)

* feat: human-readable error on bad site or base

* fix: human-readable error should have 1 config option

* docs: update README

* chore: changeset

* docs: mention localhost for testing via netlify CLI

1 files changed, 9 insertions, 3 deletions

diff --git a/packages/integrations/netlify/readme.md b/packages/integrations/netlify/readme.md
index 24fdb5187..3e9d7879b 100644
--- a/packages/integrations/netlify/readme.md
+++ b/packages/integrations/netlify/readme.md
@@ -2,14 +2,18 @@
 
 Deploy your server-side rendered (SSR) Astro app to [Netlify](https://www.netlify.com/).
 
-Use this adapter in your Astro configuration file:
+Use this adapter in your Astro configuration file, alongside a valid deployment URL:
 
 ```js
 import { defineConfig } from 'astro/config';
 import netlify from '@astrojs/netlify/functions';
 
 export default defineConfig({
-	adapter: netlify()
+	adapter: netlify(),
+  // Where your Netlify app will be deployed.
+  // Feel free to use a local URL (i.e. http://localhost:8080)
+  // to test local builds via the netlify CLI
+  site: 'https://my-production-url.netlify.app',
 });
 ```
 
@@ -23,7 +27,9 @@ netlify deploy
 
 ## Configuration
 
-The output folder is configuration with the `dist` property when creating the adapter.
+### dist
+
+We build to a `netlify` directory at the base of your project. To change this, use the `dist` option:
 
 ```js
 import { defineConfig } from 'astro/config';