docs: clarify Event.new() optional and auto-generated properties

[checkzhao8888]

Linked issue

• See Clarify auto-generated properties for new class methods #1473

Description

Clarifies the Event.new() docstring to align with RFC terminology used elsewhere in the project (for example, #1459 for Calendar.new()).

Changes:

• Replace the misleading summary "with all required properties" with "Create a new event."
• Mark optional parameters explicitly.
• Document auto-generated UID and DTSTAMP values when arguments are None.

AI disclosure: Grok assisted with reviewing RFC terminology, comparing existing new() docstring patterns, and drafting the update.

Checklist

• I've added a change log entry to /news, following the instructions in Change log entry format.
• I've added or updated tests if applicable.
• I've run and ensured all tests pass locally by following Run tests.
• I've added or edited documentation, both as docstrings to be rendered in the API documentation and narrative documentation, as necessary.

[github-actions]

Profile summary:

GitHub user: checkzhao8888
🟢 No concerns found with user's profile.
🟢 No concerns found with recent PR activity.
🟢 No concerns found with recent issue activity.

For a more detailed report, run `gh-profiler checkzhao8888`.

Full profile

GitHub user: checkzhao8888
🟢 No concerns found with user's profile.
   🟢 Account age: 5 months
   🟢 Profile information:
        name: Checkzhao
        blog: aws.checkzhao.com
        location: Singapore
        email: 475152974zhao@gmail.com
        bio:
          Former ops → AI automation solo builder.
          Building http://aws.checkzhao.com in public.
          Codex · Antigravity · GPT · agents · workflows
        twitter: https://x.com/wkngsn72674
      Empty fields: company

🟢 No concerns found with recent PR activity.
   1 PR opened in the last 21 days.
      0 opened against repos the user owns.
      0 opened against repos in publicly associated orgs.
      1 opened against external repos.

   🟢 0 of 1 external PRs merged in the last 21 days.
   🟢 0 of 1 external PRs closed without merging in the last 21 days.

🟢 No concerns found with recent issue activity.
   🟢 No new issues opened in the last 21 days.

[read-the-docs-community]

Documentation build overview

📚 icalendar | 🛠️ Build #33969978 | 📁 Comparing c44b319 against latest (937f6fc)

  🔍 Preview build  

99 files changed · + 3 added · ± 96 modified

+ Added

• contribute/join-the-icalendar-team.html
• how-to/configure.html
• reference/api/icalendar.config.html

± Modified

• 404.html
• genindex.html
• py-modindex.html
• _static/webpack-macros.html
• contribute/code-of-conduct.html
• contribute/credits.html
• contribute/development.html
• contribute/index.html
• contribute/maintenance.html
• how-to/index.html
• and 86 more...

[niccokunzmann]

@angatha, I will assign this to you. I cannot wrap my head around wether this is useful. Feel free to call in steve or close it if there is no response.

[stevepiercy]

With the suggested changes, I will approve. Thank you!

[stevepiercy]

Thank you for your contribution. Will auto-merge after CI passes.

[coveralls]

coverage: 98.085%. remained the same — checkzhao8888:docs/clarify-event-new-docstring into collective:main