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

feat: improve registration patterns docs #5808

Conversation

siiddhantt
Copy link
Contributor

Closes #5669

  • Improved registering_workflows docs with updated and new note for issues and workaround

Screenshots

Screenshot 2024-10-04 at 7 16 08 PM Screenshot 2024-10-04 at 7 16 22 PM

Check all the applicable boxes

  • I updated the documentation accordingly.
  • All new and existing tests passed.

Copy link

welcome bot commented Oct 4, 2024

Thank you for opening this pull request! 🙌

These tips will help get your PR across the finish line:

  • Most of the repos have a PR template; if not, fill it out to the best of your knowledge.
  • Sign off your commits (Reference: DCO Guide).

docs/flyte_fundamentals/registering_workflows.md Outdated Show resolved Hide resolved
If you encounter a ``ModuleNotFoundError`` when packaging, ensure to include the correct source paths by using the `--source` option. For instance:

```{prompt} bash $
pyflyte --pkgs <dir1> package --source ./src -f
Copy link
Contributor

Choose a reason for hiding this comment

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

@wild-endeavor
I know the "old" flags still work but wanted to double-check that this command would still be valid even if we deprecate the old flags? (re flyteorg/flytekit#2690)

@neverett
Copy link
Contributor

neverett commented Oct 7, 2024

Hi @siiddhantt the file you're updating has been moved to /docs/user_guide/flyte_fundamentals/registering_workflows.md -- could you merge master into your branch and apply your changes to the doc in the new location? Thanks!

@siiddhantt
Copy link
Contributor Author

siiddhantt commented Oct 7, 2024

hi @neverett , merged master into this branch, hope it's good now. Thanks!

siiddhantt and others added 6 commits October 8, 2024 02:45
Signed-off-by: Siddhant Rai <[email protected]>
Signed-off-by: Siddhant Rai <[email protected]>
* move flytekit and flytectl docs into API section

Signed-off-by: nikki everett <[email protected]>

* switch to docsearch module and env variables

Signed-off-by: nikki everett <[email protected]>

* reorganize content for pydata theme

Signed-off-by: nikki everett <[email protected]>

* more docs reorganization

Signed-off-by: nikki everett <[email protected]>

* switch to pydata theme

Signed-off-by: nikki everett <[email protected]>

* reorganize concepts/glossary and ecosystem docs

Signed-off-by: nikki everett <[email protected]>

* remove unneeded custom CSS and JS files

Signed-off-by: nikki everett <[email protected]>

* add redirects

Signed-off-by: nikki everett <[email protected]>

* add more redirects

Signed-off-by: nikki everett <[email protected]>

* first pass at updating docs contributing guide

Signed-off-by: nikki everett <[email protected]>

* remove core use cases

Signed-off-by: nikki everett <[email protected]>

* more edits to docs contributing guide

Signed-off-by: nikki everett <[email protected]>

* more edits to the flytesnacks contributing guide

Signed-off-by: nikki everett <[email protected]>

* add content to API reference index page, use consistent title and format for API reference section titles

Signed-off-by: nikki everett <[email protected]>

* rename deployment section

Signed-off-by: nikki everett <[email protected]>

* reorganize sections

Signed-off-by: nikki everett <[email protected]>

* fix typos

Signed-off-by: nikki everett <[email protected]>

* add docsearch index name and app id

Signed-off-by: nikki everett <[email protected]>

* add ref to docs contributing doc and move all docsearch stuff to env vars again

Signed-off-by: nikki everett <[email protected]>

* docs overhaul: render flyteidl under the /api/ path (flyteorg#5802)

* fix flyteidl structure so it renders under /api/

Signed-off-by: Niels Bantilan <[email protected]>

* do not check in flyteidl docs

Signed-off-by: Niels Bantilan <[email protected]>

* update gitignore and unneeded conf

Signed-off-by: Niels Bantilan <[email protected]>

* add mock DOCSEARCH_API_KEY to docs test ci

Signed-off-by: Niels Bantilan <[email protected]>

* add css styling (flyteorg#5803)

* add css styling

Signed-off-by: Niels Bantilan <[email protected]>

* update logo height

Signed-off-by: Niels Bantilan <[email protected]>

---------

Signed-off-by: Niels Bantilan <[email protected]>

---------

Signed-off-by: Niels Bantilan <[email protected]>

* use same icon as union docs

Signed-off-by: nikki everett <[email protected]>

* sp error

Signed-off-by: Niels Bantilan <[email protected]>

---------

Signed-off-by: nikki everett <[email protected]>
Signed-off-by: Niels Bantilan <[email protected]>
Co-authored-by: Niels Bantilan <[email protected]>
Signed-off-by: Siddhant Rai <[email protected]>
@siiddhantt siiddhantt force-pushed the feat/improve-registration-patterns-docs branch from 755f3a3 to 2347fbe Compare October 7, 2024 21:15
neverett
neverett previously approved these changes Oct 7, 2024
Copy link
Contributor

@neverett neverett left a comment

Choose a reason for hiding this comment

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

I left a few suggestions, but otherwise this looks good to me. Thanks!

Copy link

codecov bot commented Oct 8, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 36.69%. Comparing base (b9900fe) to head (b3c0f97).
Report is 49 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #5808      +/-   ##
==========================================
+ Coverage   36.35%   36.69%   +0.33%     
==========================================
  Files        1304     1304              
  Lines      110147   111538    +1391     
==========================================
+ Hits        40042    40924     +882     
- Misses      65938    66447     +509     
  Partials     4167     4167              
Flag Coverage Δ
unittests-datacatalog 51.37% <ø> (ø)
unittests-flyteadmin 55.60% <ø> (ø)
unittests-flytecopilot 12.17% <ø> (ø)
unittests-flytectl 62.40% <ø> (+0.18%) ⬆️
unittests-flyteidl 7.17% <ø> (ø)
unittests-flyteplugins 53.35% <ø> (ø)
unittests-flytepropeller 42.02% <ø> (ø)
unittests-flytestdlib 55.37% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@davidmirror-ops davidmirror-ops merged commit 54a4ad9 into flyteorg:master Oct 31, 2024
50 checks passed
Copy link

welcome bot commented Oct 31, 2024

Congrats on merging your first pull request! 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Docs] Improve registration patterns docs
5 participants