docs: authorizing kargo stages to modify argo apps

[fykaa]

closes #2440

I have made the documentation placement for the kargo.akuity.io/authorized-stage annotation in "Managing User Permissions" section because imo it is a key component in managing permissions between Kargo and Argo CD.

While I also considered options like a dedicated annotation reference guide or including it in key concepts, I believe current placement is most relevant. Please let me know if this location works or if there's an alternative section recommended.

[netlify]

✅ Deploy Preview for docs-kargo-io ready!

Name	Link
🔨 Latest commit	7e3d6fd
🔍 Latest deploy log	https://app.netlify.com/sites/docs-kargo-io/deploys/6769d8c24f490a00083382d3
😎 Deploy Preview	https://deploy-preview-2921.docs.kargo.io
📱 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 configuration.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 51.40%. Comparing base (c0d47e0) to head (7e3d6fd).
Report is 114 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2921      +/-   ##
==========================================
+ Coverage   49.92%   51.40%   +1.48%     
==========================================
  Files         275      288      +13     
  Lines       24668    26108    +1440     
==========================================
+ Hits        12315    13421    +1106     
- Misses      11676    11961     +285     
- Partials      677      726      +49     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[krancour]

I have made the documentation placement for the kargo.akuity.io/authorized-stage annotation in "Managing User Permissions" section because imo it is a key component in managing permissions between Kargo and Argo CD.

I'm not sure I agree with this. It has nothing to do with user permissions.

We probably need to carve out a whole separate page for "Argo CD Integration". It can be very light on content for now with a notice that the page is under construction and the real content can, for now, be limited to what you're adding here.

[akuitybot]

Successfully created backport PR for release-1.1:

• chore(backport release-1.1): docs: authorizing kargo stages to modify argo apps #3190