Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a troubleshooting section for the converter guidance #1352

Closed
wants to merge 2 commits into from

Conversation

pshao25
Copy link
Member

@pshao25 pshao25 commented Aug 12, 2024

As titled.

@pshao25 pshao25 changed the title Add a troubleshooting section for converter Add a troubleshooting section for the converter guidance Aug 12, 2024
@azure-sdk
Copy link
Collaborator

No changes needing a change description found.

@azure-sdk
Copy link
Collaborator

You can try these changes here

🛝 Playground 🌐 Website 📚 Next docs

```

you could bypass it by the configuration in this [page](https://github.com/Azure/autorest.csharp/blob/feature/v3/docs/mgmt/readme.md#list-exception).

## How to Get Help

- Ask questions in the [TypeSpec Discussions Channel](https://teams.microsoft.com/l/channel/19%3a906c1efbbec54dc8949ac736633e6bdf%40thread.skype/TypeSpec%2520Discussion%2520%25F0%259F%2590%25AE?groupId=3e17dcb0-4257-4a30-b843-77f47f1d4121&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we use aka.ms link here?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We will delete this workaround after we remove the .net dependency. I prefer not to add an aka item.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here is the short link for this channel https://aka.ms/typespec/discussions.
We need support TypeSpec migration for quite some time, so this line should remain in the document.


### Error "does not have a GetAll method"

If converter fails withe error
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo? 'withe'

fatal | The ResourceCollection RestorePointCollection (RequestPath: {Certain request path}) does not have a GetAll method
```

you could bypass it by the configuration in this [page](https://github.com/Azure/autorest.csharp/blob/feature/v3/docs/mgmt/readme.md#list-exception).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No quite sure about the action here.
By checking the link, do you suggest to update the config or update the Swagger to solve the problem?

@pshao25
Copy link
Member Author

pshao25 commented Aug 13, 2024

Synced offline. We will add suppression by default. Azure/azure-sdk-tools#8827

@pshao25 pshao25 closed this Aug 13, 2024
@pshao25 pshao25 deleted the converterDoc branch January 21, 2025 04:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants