fix: import in swift and apple docs

[ChiragAgg5k]

Summary by CodeRabbit

• Documentation
  • Simplified permission-related imports in generated documentation examples for Swift and .NET so Permission and Role are handled consistently (no conditional import behavior).
  • Clarified examples to reduce confusion around permission/role references in docs.

[coderabbitai]

Walkthrough

Conditional import blocks were removed from two documentation template files. The templates previously wrapped imports for Permission and Role (named from {{ spec.title | caseUcfirst }}) with a hasPermissionParam check; those conditional blocks were deleted, and the guarded imports no longer appear in the generated output for either Swift or .NET examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Files to inspect:
  • templates/swift/docs/example.md.twig
  • templates/dotnet/docs/example.md.twig
• Review focus:
  • Verify generated examples for methods that reference Permission/Role types to ensure no missing imports or broken references.
  • Confirm the change is intentional (i.e., that removing the conditional does not require adding the imports unconditionally or reintroducing the guard).

Pre-merge checks and finishing touches

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Title Check	⚠️ Warning	The pull request title "fix: import in swift and apple docs" is partially related to the changeset but contains inaccurate terminology. The changes indeed remove conditional imports in documentation template files, which aligns with "fix: import". However, the title states the changes are in "swift and apple docs" when the actual modified files are templates/swift/docs/example.md.twig and templates/dotnet/docs/example.md.twig. The term "apple docs" does not accurately represent the dotnet documentation template that was modified, making the title misleading about the actual scope of the changes.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix-permissions-import

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8594bf9 and fad05db.

📒 Files selected for processing (1)

• templates/dotnet/docs/example.md.twig (0 hunks)

💤 Files with no reviewable changes (1)

• templates/dotnet/docs/example.md.twig

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull Request Overview

This PR removes conditional import logic for Permission and Role types from documentation template examples in Swift and .NET. The changes eliminate the hasPermissionParam conditional checks that previously controlled whether permission-related imports were included in generated documentation.

Key changes:

• Removed conditional permission/role import blocks from Swift documentation templates
• Removed conditional permission/role import blocks from .NET documentation templates

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
templates/swift/docs/example.md.twig	Removed conditional import block for Permission and Role classes
templates/dotnet/docs/example.md.twig	Removed conditional import block for Permission and Role namespaces

Comments suppressed due to low confidence (2)

templates/swift/docs/example.md.twig:1

• The removal of conditional permission imports may cause documentation examples to fail if Permission or Role types are referenced in method parameters but no longer imported. Verify that these imports are now handled elsewhere (e.g., always included or imported through another mechanism) to ensure generated examples remain valid.

import {{ spec.title | caseUcfirst }}

templates/dotnet/docs/example.md.twig:1

• The removal of conditional permission using statements may cause documentation examples to fail if Permission or Role types are referenced in method parameters but no longer imported. Verify that these using statements are now handled elsewhere (e.g., always included or imported through another mechanism) to ensure generated examples remain valid.

using {{ spec.title | caseUcfirst }};

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.