You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Since the release of 5.x, the intercom-php documentation/readme has been completely useless. Going from the client initialisation (#381) to the request building, a lot of things have been type hinted and documentation not updated at all.
A migration guide would actually be amazing considering it's very painful to migrate going from one endpoint to another and manually looking for the types.
Simple example :
The contacts()->create() method now accept any of these objects instead of an array :
Hi! Thanks for the feedback. We have just merged an updated README and will be releasing a new version to packagist soon to include the updates in the registry. We are planning to add a migration guide within the next few weeks, so look out for that as well!
I just read the new README and all I can say is that it's still unclear.
A migration guide will be useful for people already using the SDK but for any new team, understanding which endpoints are available, how to call them etc. will be a nightmare.
The previous documentation was fairly thorough when it came to listing the endpoints and what to do with actual examples.
While I understand the switch to Fern to streamline SDK developments, you're Fern config definitely needs to be checked out to improve SDK Readme and API reference doc to include actual examples using the SDK.
Also, the newly generated contract completely sucks. Why create a DTO for each request when you’re just passing an array into it? Maybe it would be better if an actual human reviewed this slop before making it a new major release.
Activity
Tlapi commentedon Sep 9, 2025
Also there is no information on what has changed form 4.x to 5.x whatsoever.
I mean, this:
What's Changed
🌿 New SDK released by fern on August 11, 2025 by https://github.com/fern-api[bot] in #378
Is not so helpfull, is it.
fern-support commentedon Sep 25, 2025
Hi! Thanks for the feedback. We have just merged an updated README and will be releasing a new version to packagist soon to include the updates in the registry. We are planning to add a migration guide within the next few weeks, so look out for that as well!
blackjak231 commentedon Oct 8, 2025
I just read the new README and all I can say is that it's still unclear.
A migration guide will be useful for people already using the SDK but for any new team, understanding which endpoints are available, how to call them etc. will be a nightmare.
The previous documentation was fairly thorough when it came to listing the endpoints and what to do with actual examples.
While I understand the switch to Fern to streamline SDK developments, you're Fern config definitely needs to be checked out to improve SDK Readme and API reference doc to include actual examples using the SDK.
Eclairemoy commentedon Oct 8, 2025
Hey @blackjak231 thanks for the feedback about including some examples using the SDK, we'll start working on that.
Have you had a chance to check out this yet? Curious if it helps at all with the migration piece of this.
SystematicCZ commentedon Nov 7, 2025
Also, the newly generated contract completely sucks. Why create a DTO for each request when you’re just passing an array into it? Maybe it would be better if an actual human reviewed this slop before making it a new major release.