Expand and improve Client docs

[hanpaine]

What does it do?

• adds documentation for client.files.upload as implemented in Upload New Media File client#92
• extends and improves documentation for initialization and authentication slightly

** note this documentation was created with the help of Dosu :)

Why is it needed?

Documentation for media upload is currently missing from Strapi docs.

Related issue(s)/PR(s)

strapi/client#92

[strapi-cla]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ pwizla
❌ hanpaine
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
documentation	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 24, 2025 1:54pm

[innerdvations]

Is this your first Strapi PR?! 🎉

I gave it a quick look but haven't tested the code examples yet

[pwizla]

Hey @hanpaine!

Congrats on your very first docs PR! It's already great 🫶
I did a light review and added some comments.

However, upon further inspection 👀 , it seems I need to do a deeper rewrite. Because what's new is actually adding the upload method, but all the other ones are still valid (find, findOne, update, delete), right?

So I will largely reorganize the content, for consistency and clarity. Thank you very much again for your base work, it's really helpful! 👏
And then I'll ping devs for a tech review 👀

[pwizla]

@hanpaine I finished rewriting the PR content so it better fits with the existing information architecture.
@innerdvations and @jhoward1994 , feel free to review the technical accuracy 👀 🙏

(The only thing that's bugging me is that it's using "ids" in code examples. I thought we switched to documentId in Strapi 5. Unless this does not apply to the Media Library or Client? 🤔)

[github-actions]

👋 Thanks for contributing to Strapi's documentation!

I've reviewed the changes in your file, and here's what I found:

🎉 Excellent work! Your documentation perfectly follows all our writing guidelines.

What this means:
✅ Professional, clear tone throughout
✅ Well-structured content that's easy to follow
✅ Inclusive language that welcomes all readers

Your contribution is ready to help developers worldwide! 🌍

📚 Helpful Resources:
📖 Strapi's 12 Rules of Technical Writing
🎨 Documentation Style Guide

---

🤖 This review focuses only on the lines you've changed. Questions? Feel free to ask in the comments!

🔧 Manually triggered validation for PR #2602