FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Fix Python doc links in Docs and add `HdfsSink` back by Yuqing-cat · Pull Request #383 · feathr-ai/feathr · GitHub

/ feathr Public

Fix Python doc links in Docs and add HdfsSink back - #383

Merged
Yuqing-cat merged 2 commits into
feathr-ai:mainfrom
Yuqing-cat:docfix
Jun 21, 2022
ConversationCommits (2)ChecksFiles changed
Merged

Fix Python doc links in Docs and add HdfsSink back#383
Yuqing-cat merged 2 commits into
feathr-ai:mainfrom
Yuqing-cat:docfix

Conversation

Yuqing-cat commented Jun 20, 2022 •
edited by jainr
Loading

Copy link
Copy Markdown
Collaborator

Fix the side effect of #198

  • Update all Python doc links in docs
  • Add HdfsSink into __all__ section of feathr_project/feathr/__init__.py
  • Add notes in docs/dev_guide/update_python_docs.md

Note:

  • As mentioned in docs/dev_guide/update_python_docs.md:
    • Add an __all__ section in __init__.py (see code here). Every components that are included in the __all__ section is exposed to end users. Others are not exposed in the pydocs.

I'm not sure if the HdfsSink is not included by design. If it shouldn't expose to users, then the section in docs/concepts/feature-generation.md should be removed.

Yuqing-cat added bug Something isn't working documentation Improvements or additions to documentation labels Jun 20, 2022
Yuqing-cat linked an issue Jun 20, 2022 that may be closed by this pull request
Python Doc links in Docs are not updated after a folder structure upgrade #382
Closed

xiaoyongzhu commented Jun 21, 2022

Copy link
Copy Markdown
Member

Thanks! In order to make it a bit more user friendly (i.e. users can import from the feathr module, it's a bit manual to add user facing APIs there.

There were some automated ways, but seems they are too automated and need many manual changes to tell whether a certain API is needed or not.

Yuqing-cat commented Jun 21, 2022

Copy link
Copy Markdown
Collaborator Author

Thanks! In order to make it a bit more user friendly (i.e. users can import from the feathr module, it's a bit manual to add user facing APIs there.

There were some automated ways, but seems they are too automated and need many manual changes to tell whether a certain API is needed or not.

I see.
For this PR, I only covered all Python API links in Docs. Currently, we don't have an official guide for which modules should be exposed to users or not. Thus, I cannot help to check if there are other missing modules in all.

Yuqing-cat merged commit b3b126c into feathr-ai:main Jun 21, 2022
blrchen reviewed Jun 21, 2022
View reviewed changes
Comment thread feathr_project/feathr/__init__.py
'MaterializationSettings',
'MonitoringSettings',
'RedisSink',
'HdfsSink',

blrchen Jun 21, 2022 •
edited
Loading

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

i am curious why materialize test can pass without this., does that means HdfsSink already included in other place?

This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

blrchen blrchen left review comments
xiaoyongzhu xiaoyongzhu approved these changes
jainr jainr approved these changes
hangfei Awaiting requested review from hangfei
jaymo001 Awaiting requested review from jaymo001
edwincheung Awaiting requested review from edwincheung
windoze Awaiting requested review from windoze

Assignees

No one assigned

Labels

bug Something isn't working documentation Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Python Doc links in Docs are not updated after a folder structure upgrade

4 participants

Back | FazBrowse Home | New Git URL