Add feature directories to project structure guide

[TheOtterlord]

What kind of changes does this PR include?

• New or updated content

Description

• Closes Add src/content/ to project structure guide #2797
• What does this PR change? Adds a section "Feature Directories" to the project structure guide to describe src/content & src/assets

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	aad2b6b
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/64626905dc216800083e770e
😎 Deploy Preview	https://deploy-preview-3237--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 settings.

[sarah11918]

Good call, @TheOtterlord! I'm wondering what we should call these directories. We might refer to them as "reserved" directories internally (as opposed to "feature" directories) because that also conveys that you can't have these folders yourself for other things... they really are reserved in Astro.

[sarah11918]

Also, I'd be tempted to put these up with the other folders, and just say in each folder that it's reserved, vs a special section, I think? Just a first thought.

[TheOtterlord]

Yep! I like that.

I struggled between "Reserved" and "Features" because I don't think src/assets is exactly reserved? But we are trying to get across the fact that these are things you probably shouldn't use unless you use them their intended way. So specifying it in each directory's text should be plenty.

[sarah11918]

Thanks, @TheOtterlord! I've made some suggestions here, and again, I think we should move these up to where the other folders are explained. I don't think this should be a separate category, but rather, these folders should occur in alphabetical order on the page.

So, I would put src/assets/ right after src/ and I would put src/content/ after src/components/. Leave each folder itself to describe what it does, whether it's reserved etc.

I'm not sure why a bunch of checks are failing (could be a fluke!) but let's get this content in the right spot, then figure that out! 😄

[TheOtterlord]

Seems the CI fixed itself :D

[sarah11918]

Looking great now, I think! The src/assets/ content was just moved a little too high up, so I brought it back down. And, I threw the word "reserved" into src/content/, but I think with these changes, we're good to go! 🙌

[sarah11918]

D'oh! I realized that while I ALWAYS refer to folders with a trailing slash... none of the other sidebar entries do. 😅 So, I'll just quickly revert those for consistency, then I'll get you in the "update branch" queue and merged! 🎉