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

[WIP] add docstrings in mms classes and functions #1101

Merged
merged 2 commits into from
May 22, 2023

Conversation

rnyak
Copy link
Contributor

@rnyak rnyak commented May 18, 2023

This is still WIP.

@rnyak rnyak added the documentation Improvements or additions to documentation label May 18, 2023
@rnyak rnyak added this to the Merlin 23.06 milestone May 18, 2023
@gabrielspmoreira gabrielspmoreira force-pushed the tf/doc_strings_update branch from 8efbd36 to 48b4998 Compare May 19, 2023 14:13
@gabrielspmoreira gabrielspmoreira deleted the branch tf/doc_strings_update May 19, 2023 14:18
@rnyak rnyak reopened this May 22, 2023
@@ -34,52 +34,55 @@ def DLRMBlock(
*,
embedding_dim: int = None,
embedding_options: EmbeddingOptions = None,
embeddings: Optional[Block] = None,
Copy link
Contributor

Choose a reason for hiding this comment

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

Let's not move the order of arguments if possible - it's a breaking change in the unlikely case where people provide all of the arguments in order as opposed to using named arguments.

Copy link
Member

Choose a reason for hiding this comment

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

The * on line 34 forces the remaining arguments to be keword arguments. which makes them robust to the order here

Copy link
Contributor Author

@rnyak rnyak May 22, 2023

Choose a reason for hiding this comment

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

@nv-alaiacano thanks for your comment. Make sense, I talked to Oliver, I think we are safe changing the position of the arg thanks to * arg there. It makes everything forced to be a keyword arg, rather than a positional arg.

@rnyak rnyak merged commit 7ee8e84 into tf/doc_strings_update May 22, 2023
@rnyak rnyak deleted the add_tf_docstrings_rny branch May 22, 2023 14:46
edknv added a commit that referenced this pull request Jun 12, 2023
* Fixed docstrings

* [WIP] add docstrings in mms classes and functions (#1101)

* add docstings

* add docstrings

* Add docstrings (#1106)

* Add docstrings to Encoder

* Add docstrings to ItemRetrievalScorer

* Add docstrings to Model

* Fix docstring for TwoTowerModel

* Add docstring to YoutubeDNNRetrievalModelV2

* Add docstrings to L2Norm

* Add docstrings to ContinuousFeatures

* Add docstrings to AverageEmbeddingsByWeightFeature

* Add docstrings to ReplaceMaskedEmbeddings

* Add docstrings to SequenceEmbeddingFeatures

* Add docstrings to EmbeddingTable

* lint

* lint

* lint

* update docstring syntax

---------

Co-authored-by: Gabriel Moreira <gmoreira@nvidia.com>
Co-authored-by: rnyak <16246900+rnyak@users.noreply.github.com>
Co-authored-by: Adam Laiacano <alaiacano@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation skip-base-branch-check
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants