Skip to content
This repository has been archived by the owner on Apr 6, 2023. It is now read-only.

docs: add nuxt layers introduction and authoring guide #9405

Merged
merged 33 commits into from
Dec 5, 2022

Conversation

cpreston321
Copy link
Contributor

@cpreston321 cpreston321 commented Nov 29, 2022

❓ Type of change

  • 📖 Documentation (updates to the documentation or readme)
  • 🐞 Bug fix (a non-breaking change that fixes an issue)
  • 👌 Enhancement (improving an existing functionality like performance)
  • ✨ New feature (a non-breaking change that adds functionality)
  • ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

This adds more detail about the how to use extends since it's very powerful with little documentation we have now on this feature. I wanted to help out but hopefully this is a start to show off how nice of a feature this is. If you need modify it or change the structure on where it's located please let me know!

Thanks 💚

📝 Checklist

  • I have linked an issue or discussion.
  • I have updated the documentation accordingly.

@codesandbox
Copy link

codesandbox bot commented Nov 29, 2022

CodeSandbox logoCodeSandbox logo  Open in CodeSandbox Web Editor | VS Code | VS Code Insiders

@atinux atinux requested a review from manniL November 29, 2022 16:54
@cpreston321 cpreston321 changed the title feat(docs): Extend Theme Config docs(extend-configs): added new section for extends feature Nov 29, 2022
@cpreston321 cpreston321 changed the title docs(extend-configs): added new section for extends feature docs(extend-theme): added new section for extends feature Nov 29, 2022
Copy link
Member

@manniL manniL left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good start! Left some remarks

docs/content/1.docs/1.getting-started/3.extends-theme.md Outdated Show resolved Hide resolved
docs/content/1.docs/1.getting-started/3.extends-theme.md Outdated Show resolved Hide resolved
docs/content/1.docs/1.getting-started/3.extends-theme.md Outdated Show resolved Hide resolved
docs/content/1.docs/1.getting-started/3.extends-theme.md Outdated Show resolved Hide resolved
docs/content/1.docs/1.getting-started/3.extends-theme.md Outdated Show resolved Hide resolved
@cpreston321
Copy link
Contributor Author

@manniL Updated ✅

@pi0 pi0 self-requested a review December 2, 2022 09:41
@pi0
Copy link
Member

pi0 commented Dec 2, 2022

Thanks for the PR @cpreston321 ❤️

I like to move it to Guide > Going Further > Nuxt Layers to be consistent with the starter name (nuxt/starter#183) and generally the way we announce this feature.

What do you think @antfu @danielroe @atinux?

@manniL
Copy link
Member

manniL commented Dec 2, 2022

I like to move it to Guide > Going Further > Nuxt Layers to be consistent with the starter name (nuxt/starter#183) and generally the way we announce this feature.

We call all things we can extends layers then, right? (Just want to nail the terminology)

@pi0 pi0 self-assigned this Dec 2, 2022
@pi0
Copy link
Member

pi0 commented Dec 2, 2022

(working on some refactors to try splitting into user guide + author guide)

We call all things we can extend layers then, right? (Just want to nail the terminology)

Yes, that's almost the idea having a consistent naming for the feature :)

@danielroe danielroe requested review from clemcode and removed request for clemcode December 2, 2022 10:54
Copy link
Member

@danielroe danielroe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a great initiative - many thanks indeed! ❤️

@pi0 pi0 requested a review from atinux December 2, 2022 14:09
@cpreston321
Copy link
Contributor Author

Glad to see that everyone is helping - this feature is so powerful.

I appreciate you all 💚

@cpreston321
Copy link
Contributor Author

cpreston321 commented Dec 3, 2022

related issue when adding nitro layers to extend repo as a node module: nuxt/nuxt#15768

@manniL
Copy link
Member

manniL commented Dec 3, 2022

Also important to consider: https://github.com/nuxt/framework/discussions/9418

@pi0 pi0 changed the title docs(extend-theme): added new section for extends feature docs: add nuxt layers introduction and authoring guide Dec 5, 2022
@pi0 pi0 merged commit 77e2974 into nuxt:main Dec 5, 2022
@pi0
Copy link
Member

pi0 commented Dec 5, 2022

Thanks all for helping on this 🙌 Let's iterate to improve layers support and docs.

@atinux
Copy link
Member

atinux commented Dec 5, 2022

Was going to push, could have wait for my approval that was coming in few minutes, anyway will push my changes directly to main 👍

@pi0 pi0 mentioned this pull request Dec 15, 2022
6 tasks
@cpreston321 cpreston321 deleted the feat/extendsDocs branch December 16, 2022 18:43
@danielroe danielroe added the 3.x label Jan 19, 2023
@danielroe danielroe mentioned this pull request Jan 20, 2023
danielroe added a commit that referenced this pull request Jan 21, 2023
Co-authored-by: Alexander Lichter <github@lichter.io>
Co-authored-by: Sébastien Chopin <seb@nuxtjs.com>
Co-authored-by: Pooya Parsa <pooya@pi0.io>
Co-authored-by: Daniel Roe <daniel@roe.dev>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants