[Docs] Revise Vizro-AI docs to align with style guide

[stichbury]

Description

Now ready for review. You can see the built docs here: https://vizro--381.org.readthedocs.build/projects/vizro-ai/en/381/

I have made changes that should be familiar given the set I've made on vizro-core to follow the style guide. For example, I've change capitalisation in headers to sentence case.

I also rationalised the installation guide to align it more closely to the one for vizro-core and I converted a page to FAQs since it was better titled to answer common queries. The LLM API key content moves into the installation guide since, for now at least, it's covering just OpenAI and doesn't need to keep redirecting the reader around the docs to different places. I think getting the .env file set up is probably the most confusing thing for novice users who are unfamiliar with API keys and environment settings...we need to think about about a video at some point.

I moved some text around on the index page to remove the most "promotional" copy (that can go into the README if we need it) and keep it short and useful. The box navigation is now above the fold.

Screenshot

Notice

• I acknowledge and agree that, by checking this box and clicking "Submit Pull Request":

  • I submit this contribution under the Apache 2.0 license and represent that I am entitled to do so on behalf of myself, my employer, or relevant third parties, as applicable.
  • I certify that (a) this contribution is my original creation and / or (b) to the extent it is not my original creation, I am authorized to submit this contribution on behalf of the original creator(s) or their licensees.
  • I certify that the use of this contribution as authorized by the Apache 2.0 license does not violate the intellectual property rights of anyone else.
  • I have not referenced individuals, products or companies in any commits, directly or indirectly.
  • I have not added data or restricted code in any commits, directly or indirectly.

[nadijagraca]

Really good job Jo. I love the new docs. 🚀

[maxschulz-COL]

I am being a pain, I cannot approve this as you didn't click the button 😂 @Joseph-Perkins

[huong-li-nguyen]

LGTM in general 👍 Have a few comments and question!

[maxschulz-COL]

Hey Jo, I think we can still work a little bit on shuffling the sections. I think also some of the pages have gotten lost 🤔 ?

[huong-li-nguyen]

🚀

[maxschulz-COL]

I think we have a duplicated section, but after that I think we are good to go! Really good overhaul, and it is already much more concise 💪

One last idea: shall we move the FAQs to the Explanation section, then I think we are super clean and following the diataxis framework well!

I've made the changes as requested