[v3 checks] markdown.draft

[sarah11918]

📚 Subject area/topic

markdown.draft

📋 Page(s) affected (or suggested, for new content)

https://docs.astro.build/en/guides/markdown-content/#draft-pages

📋 General description or bullet points (if proposing new content)

@bluwy to check this section of the Markdown page and make any relevant changes based on withastro/astro#8099 (markdown.draft deprecated). Notably (but not limited to, if you notice something else!!):

1. Is mdx.draft still fine?
2. Is the method of Astro.glob() shown for filtering based on draft:true still fine, BUT the config option to build by default is gone, or should the ENTIRE notion of draft Markdown pages when NOT using content collections be removed?

Thanks! 🙌

🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)

none

[bluwy]

I'll send a PR, but gonna fill in the answers here for context first:

1. Is mdx.draft still fine?

Anything draft except via content collections should be removed. So MDX drafts should also be removed, but markdown would be the most common case especially that our option is named markdown.draft when referring it.

2. Is the method of Astro.glob() shown for filtering based on draft:true still fine, BUT the config option to build by default is gone, or should the ENTIRE notion of draft Markdown pages when NOT using content collections be removed?

Yeah I think Astro.glob and filter by draft: true is fine. But now it's more like a "this is a trick you can use if you have draft pages", than a feature to cover. So I think it makes more sense to remove it entirely?

Could also be less confusing if someone searches for "draft pages" and we'd only have one with content collections only. 🤔

[sarah11918]

Not sure why this wasn't closed automatically, but closed by #4354 ! 🥳