Docs update for includeFiles and excludeFiles options on netlify adapter

[dfdez]

Description:
Docs update for withastro/astro#13194.

Note

This PR remains in draft status pending the merge of these options into the adapter. I will mark it as ready for review once the changes are deployed to production.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/guides/integrations-guide/netlify.mdx	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[astrobot-houston]

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

1. Our GitHub bots will run to check your changes.
   If they spot any broken links you will see some error messages on this PR.
   Don’t hesitate to ask any questions if you’re not sure what these mean!

2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.

3. One or more of our maintainers will take a look and may ask you to make changes.
   We try to be responsive, but don’t worry if this takes a few days.

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	ef51945
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/67ad4cea2408480008a5c130
😎 Deploy Preview	https://deploy-preview-10760--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[sarah11918]

Thank you for submitting these docs for your feature! I've made a few suggestions below to conform to our style and language use. And, I think the examples should all refer to netlify here and not vercel, right? 😄

Also, please remove the translation file. We have a process for translation, and our PR template reminds you that you should only make a PR in one language. Thank you for following our system!

I'm looking forward to having this feature in docs!

For Team Docs looking at this PR: this PR highlights that the Netlify and Vercel docs are structured a little differently. (The Vercel documentation lists these as configuration options, whereas the Netlify docs are more "topic based." We can't fix that in this PR, but we may want to eventually move to consistency between the two! 😅

[sarah11918]

Also noting that the implementation PR changeset includes information that should be in docs itself, so we will need to work this in:

The includedFiles and excludedFiles options allow you specify these inclusions and exclusions as an array of file paths relative to the site root. Both options support glob patterns, so you can include/exclude multiple files at once.

[dfdez]

Hey @sarah11918 thanks for the feedback!

I've updated the examples to reference Netlify instead of Vercel and removed the translation file as requested.

I've also added more information to the docs as requested. Let me know if there's anything else needed 👍🏽

[sarah11918]

Just a quick note these are in really good shape, and I'm waiting on the implementation PR to be reviewed/approved (just to make sure there's no new info/nothing changes) before doing a final polish here! 🫡

[sarah11918]

Also noting that now that we've moved the adapters, this shouldn't affect the docs we've got going here, but we will need to update the PR description so we can link to the new PR to the main Astro repo instead of the closed adapters repo PR! 🙌

[sarah11918]

Thanks for updating the description to link to the new withastro/astro PR!

Reminder (for all of us) that these docs will then still need final polishing once they are out of draft, when I'll compare to the implementation PR itself, the changeset there etc.! 🙌

[dfdez]

Important comment made on the implementation PR that we should consider for the docs to 👍

[ematipico]

@sarah11918 I added the relative code PR to the next release 5.3.0

[sarah11918]

Looks great! Just some polishing changes, including making the additions more like our standard API reference. (I know, this is an older page that hasn't yet been updated in other entries, but let's at least get this one in shape!)

Please do check for accuracy!

[dfdez]

Hey @sarah11918 thanks for the feedback again!

I have made a commit including all the suggested changes 👌

[sarah11918]

Thanks so much for the updates, and thanks for also importing that <Since /> component! Welcome to Team Docs! 🥳