Skip to content

Add release notes for ML.NET 0.4 - #656

Merged
shauheen merged 3 commits into
dotnet:masterfrom
GalOshri:release-notes-0.4
Aug 7, 2018
Merged

shauheen merged 3 commits into
dotnet:masterfrom
GalOshri:release-notes-0.4

Conversation

@GalOshri

@GalOshri GalOshri commented Aug 7, 2018

Copy link
Copy Markdown
Contributor

This adds release notes for ML.NET 0.4.

Note that some of the documentation links are not available yet. They will start working after the official release.

Comment thread docs/release-notes/0.4/release-0.4.md Outdated
Today we are releasing ML.NET 0.4. During this release we have started
exploring new APIs for ML.NET that enable functionality that is missing from
the current APIs. We welcome feedback and contributions to the
[discussion](https://github.com/dotnet/machinelearning/projects/4). While the

@glebuk glebuk Aug 7, 2018 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

discussion [](start = 1, length = 10)

Is it discussion or project? the link opens as a project view. #Closed

@GalOshri GalOshri Aug 7, 2018 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The project is a collection of the relevant issues so it might be a good pointer. Should we change to something else? #Closed

@GalOshri GalOshri Aug 7, 2018 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'll update to make it clearer. #Closed

SymSGD can still be helpful in scenarios where you want to try many
different learners and limit each of them to a single thread.
* Documentation can be found
[here](https://docs.microsoft.com/en-us/dotnet/api/microsoft.ml.trainers.symsgdbinaryclassifier?view=ml-dotnet)

@glebuk glebuk Aug 7, 2018 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

https://docs.microsoft.com/en-us/dotnet/api/microsoft.ml.trainers.symsgdbinaryclassifier?view=ml-dotnet [](start = 13, length = 103)

currently not available, perhaps needs to be released together? #Closed

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yep, mentioned in the PR description that the docs.microsoft.com links will be available after the official release.

[fastText](https://en.wikipedia.org/wiki/FastText), and
[SSWE](http://anthology.aclweb.org/P/P14/P14-1146.pdf).
* Documentation can be found
[here](https://docs.microsoft.com/en-us/dotnet/api/microsoft.ml.transforms.wordembeddings?view=ml-dotnet).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This link will be available after the official release.

* Added Word Embeddings Transform for text scenarios
([#545](https://github.com/dotnet/machinelearning/pull/545))

* [Word embeddings](https://en.wikipedia.org/wiki/Word_embedding) is a

@justinormont justinormont Aug 7, 2018 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I'd say "words or phrases".

  • Word embeddings is a
    technique for mapping words or phases to numeric vectors of relatively low
    dimension (in comparison with the high dimensional n-gram extraction).
    These numeric vectors are intended to capture some of the meaning of the
    words so they can be used for training a better model. As an example,
    SSWE (Sentiment-Specific Word Embedding) can be useful for sentiment
    related tasks. #resolved

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Thanks. Addressed in next commit.

@asthana86

Copy link
Copy Markdown
Contributor

Should we call out that symSGD requires a seperate NuGet Package?

words so they can be used for training a better model. As an example,
SSWE (Sentiment-Specific Word Embedding) can be useful for sentiment
related tasks.
* This transform enables using pretrained models to get the embeddings

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We can note the word embeddings are automatically downloaded on first use. (So users don't worry about downloading them).

We may also want to state:
"The transform supports custom pre-trained models in common text formats (Word2vec, fastText, GloVe, etc), allowing users to train word embedding models on their data and use in ML.NET."

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yes I'll add this note. Regarding custom pretrained models, let's make sure we cover that in the documentation instead as it is a more advanced scenario.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Good point. We should write-up a "how to train" a custom model section in the docs.

From package manager:
```
Install-Package Microsoft.ML
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Should we link to how to build your own copy?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I don't think this is necessary for the release notes (it's more about getting started with using the package as opposed to building it).

@eerhardt

eerhardt commented Aug 7, 2018

Copy link
Copy Markdown
Member

Do we want to call out the F# and property support that went in? #616 ?

@GalOshri

GalOshri commented Aug 7, 2018

Copy link
Copy Markdown
Contributor Author

I was thinking about it but wondering if we wanted to add some more docs / tests before including it in the release notes. What do you think?

@eerhardt

eerhardt commented Aug 7, 2018

Copy link
Copy Markdown
Member

We have F# tests in the repo: https://github.com/dotnet/machinelearning/tree/master/test/Microsoft.ML.FSharp.Tests

Also, @dsyme has a PR for the samples repo to add F# samples: dotnet/machinelearning-samples#36

We can hold off if you want, but it seems like mentioning that we are adding supporting for F# record types in 0.4 would be valuable.

@GalOshri

GalOshri commented Aug 7, 2018

Copy link
Copy Markdown
Contributor Author

Sounds good. I've added "improved F# support" to the notes.

@shauheen shauheen left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

:shipit:

@shauheen
shauheen merged commit cdb9486 into dotnet:master Aug 7, 2018
shauheen pushed a commit that referenced this pull request Aug 7, 2018
@GalOshri
GalOshri deleted the release-notes-0.4 branch August 7, 2018 17:57
@ghost ghost locked as resolved and limited conversation to collaborators Mar 29, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants