Add overview document for clustering

[arovir01]

This PR adds the overview document for clustering.

This is still to be viewed as work in progress until the tutorial document will have been finalized.

[akarmi]

@arovir01, I have spotted a couple of minor things. Please, have a look.

[alanchiao]

@lamberta: could you review this PR? This is for a new weight clustering technique that we're moving forward with from this RFC.

[lamberta]

This mentions it's a work in progress, is the intention to add more docs to a /clustering section?

What goes here will publish on tensorflow.org when pulled in. If this shouldn't get published yet, you can prefix the file name with an underscore like: _index.md

Also need to update the leftnav file: https://github.com/tensorflow/model-optimization/blob/master/tensorflow_model_optimization/g3doc/_book.yaml

[alanchiao]

is the intention to add more docs to a /clustering section?
Yes there is.

If this shouldn't get published yet, you can prefix the file name with an underscore like: _index.md

Yes it's not ready for users to view since the other docs need to be added first. This doc itself is good though. The idea was to not link it into the left nav via _book.yaml so people cannot really view it on tensorflow.org. Only prior to launch, would the _book.yaml changes be made.

If underscore is preferred, we can do that for TFMOT going forward.

[lamberta]

If underscore is preferred ...

Up to you. If only working in GitHub, I'd probably recommend a feature branch or something and then merge everything when ready to publish. Files prefixed with an underscore are skipped when importing---but that also means the file won't get executed (for testing).

It's fine to publish as normal and then add a nav link when ready, as long as you're not leaking anything, etc. (But if that were the case, we wouldn't be chatting out here in GitHub :)

[alanchiao]

Ok thanks. Think it's fine to keep the file name as is then.

It matters less for this file, but for the colabs (written by another person), it's nice to be able to get things automatically tested and reviewed document by document.

[arovir01]

Also need to update the leftnav file: https://github.com/tensorflow/model-optimization/blob/master/tensorflow_model_optimization/g3doc/_book.yaml

Is this something I should do or will one of you guys handle it after merging this?

[arovir01]

I have added the latest experimental results to the document. Please advise if there is anything else that you consider needs changing. Otherwise I will proceed with squashing the commits together in preparation for merging.

[lamberta]

@arovir01 for this PR, it sounds like the entry in _book.yaml will be added later by @alanchiao

[alanchiao]

Billy, yes that's correct. Or Aron / the others will make it shortly prior to launch.

[alanchiao]

Just leaving a note that Billy approved this PR internally.