[text analytics] add --pre suffix to pip install#13523
[text analytics] add --pre suffix to pip install#13523iscai-msft merged 3 commits intoAzure:masterfrom
Conversation
ghost
added
the
|
|
||
| ```bash | ||
| pip install azure-ai-textanalytics | ||
| pip install azure-ai-textanalytics --pre |
There was a problem hiding this comment.
we need to update the Note below. Maybe be specific on what version you're getting with/without the --pre flag?
There was a problem hiding this comment.
v good point thankns
There was a problem hiding this comment.
just added a note about this. in the note i explicitly mention 5.0.0 as the latest GA version of the library, since I'm mentioning that the GA version only includes support of v3.0, and this behavior is tied to that version
| > Note: This version of the client library supports the v3.0 version of the Text Analytics service | ||
| > Note: This version of the client library supports both the v3.0 version, and the preview versions of the v3.1 version of the Text Analytics service. If you do not specify the `--pre` flag when installing the package, you will download version 5.0.0 of the library, which will only | ||
| include support of the services v3.0 version. Specifying the `--pre` flag will give you the latest beta release of this library, which includes | ||
| support of all preview versions of v3.1, and also continuing support of the service's v3.0 version. |
There was a problem hiding this comment.
this is very nit picky of me, but maybe in the future this could be conveyed better in a table that shows what the command is, the version of the client library you get, and the version of the service supported. As we support more versions, I'm concerned this note will get complicated
There was a problem hiding this comment.
I think that at most there will be two SDK versions that we talk about in the readme though (the latest GA version and the latest beta version), and for each SDK version, we really only need to mention one API version corresponding (i.e., this supports up to version xx). After typign all this out, I do think a table will look clean thoughk, so I'll make it one now
2 participants
Should include the
--prespecification when installing from pip, since there are both GA and preview versions of this library