Add Emotion FAQ to docs

[tkajtoch]

Summary

Resolves #8737

This PR adds the existing Emotion guide and frequently asked questions to the documentation site. It's the base for further content improvements.

LMK what you think of the navbar naming - I was torn between having a primary Emotion link in the top bar and having something more generic prepared for more content to come.

Note that the latest comment from Anton is not included in this PR. It's because some of the content in there is duplicated, and I feel we need to rewrite it in a way that's more readable as a whole. I want to move sections around and reduce the number of answers hidden in the FAQ section

Added pages:

• https://eui.elastic.co/pr_8741/docs/developer-guides/emotion/
• https://eui.elastic.co/pr_8741/docs/developer-guides/emotion/migrating-from-sass/

[weronikaolejniczak]

suggestion:

Let's move this to a subpage "Styling apps with Emotion".

According to our wiki:

It's possible to make a collapsible item be a document as well, though this is not recommended. Set the link field to have type: doc and id: <DOCUMENT_ID>, with the id from the document it should point to. If the id is not explicitly set in the document file's front matter, it's the relative path starting from the docs folder, without the file extension, e.g. docs/components/containers/accordion.

I think in this case we can easily put this as a "introductory" page and there's no need for the folder to be a document as well.

[tkajtoch]

Based on the Slack discussion let's make this a part of the Getting started section. Good catch on the document structure!

[weronikaolejniczak]

nit:

There's some spacing issue here.

[tkajtoch]

It's technically how our current theme renders code blocks in lists. Let's fix it separately since this PR is content-only.

[weronikaolejniczak]

@tkajtoch I don't mind doing it on another issue, can we create it though? 😄

[tkajtoch]

Of course

[tkajtoch]

#8748

[weronikaolejniczak]

Thanks for the great idea and seeing it through, Tomasz! It looks good to me, so I'm leaving an approve 🟢

Feel free to apply whatever suggestions you think are fair.

[elasticmachine]

💚 Build Succeeded

• Buildkite Build
• Commit: 7574759
• Documentation website

History

• 💚 Build #373 succeeded a3d07c3

cc @tkajtoch

[elasticmachine]

💚 Build Succeeded

• Buildkite Build
• Commit: 7574759

History

• 💚 Build #4071 succeeded a3d07c3

cc @tkajtoch