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

Readme update 2023 #4549

Merged
merged 14 commits into from
Jan 2, 2024
Merged

Readme update 2023 #4549

merged 14 commits into from
Jan 2, 2024

Conversation

davidmirror-ops
Copy link
Contributor

Why are the changes needed?

Looking to make the README a more educational resource

What changes were proposed in this pull request?

How was this patch tested?

Setup process

Screenshots

Check all the applicable boxes

  • I updated the documentation accordingly.
  • All new and existing tests passed.
  • All commits are signed-off.

Related PRs

Docs link

Signed-off-by: davidmirror-ops <[email protected]>
Signed-off-by: davidmirror-ops <[email protected]>
Signed-off-by: davidmirror-ops <[email protected]>
Signed-off-by: davidmirror-ops <[email protected]>
Signed-off-by: davidmirror-ops <[email protected]>
@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Dec 7, 2023
Copy link

codecov bot commented Dec 7, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (81ce71e) 58.11% compared to head (75a3b9c) 58.12%.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #4549   +/-   ##
=======================================
  Coverage   58.11%   58.12%           
=======================================
  Files         626      626           
  Lines       53815    53815           
=======================================
+ Hits        31277    31278    +1     
+ Misses      20036    20035    -1     
  Partials     2502     2502           
Flag Coverage Δ
unittests 58.12% <ø> (+<0.01%) ⬆️

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.

README.md Outdated
Write code in Python or any other language and leverage a robust type engine.
</p>

<img alt="Getting started with Flyte" src="https://raw.githubusercontent.com/flyteorg/static-resources/main/common/flytereadmebuildv2.gif" style="width: 100%; height: auto;" />
Copy link
Contributor

Choose a reason for hiding this comment

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

can we reduce the size of the GIF window?

Copy link
Contributor

Choose a reason for hiding this comment

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

also, i'm not sure if this is a big ask, but could we consider including a different example here? :)
this would be amazing.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That's a good example yes, the problem is that the GIF will be a bit longer (more code) and this one doesn't showcase the subworkfows that are probably not the most prominent feature but something a bit beyond the hello world

README.md Outdated


## How to stay involved?

Copy link
Contributor

Choose a reason for hiding this comment

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

can we remove the additional new lines here?

Comment on lines +112 to +113
- [Forecast sales with Horovod and Spark](https://docs.flyte.org/projects/cookbook/en/latest/auto_examples/forecasting_sales/index.html)
- [Nucleotide Sequence Querying with BLASTX](https://docs.flyte.org/projects/cookbook/en/latest/auto_examples/blast/index.html)
Copy link
Contributor

Choose a reason for hiding this comment

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

haven't tested these examples recently. but i think that's okay.

README.md Outdated
:arrows_counterclockwise: **Parallelism**: Flyte tasks are inherently parallel to optimize resource consumption and improve performance. <br />
:floppy_disk: **Allocate resources dynamically** at the task level. <br />
:play_or_pause_button: [Wait](https://docs.flyte.org/projects/cookbook/en/latest/auto_examples/advanced_composition/waiting_for_external_inputs.html) for **external inputs** before proceeding with the execution. <br />
<img alt="Getting started with Flyte, showing the welcome screen and Flyte dashboard" src="https://raw.githubusercontent.com/flyteorg/static-resources/main/flytesnacks/getting_started/getting_started_console.gif" style="width: 100%; height: auto;" />
Copy link
Contributor

Choose a reason for hiding this comment

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

we should probably place this GIF below pyflyte run --remote hello_world.py hello_world_wf command.

README.md Outdated
💾 **Allocate resources dynamically** at the task level. <br />


## Who's using Flyte?
Copy link
Contributor

Choose a reason for hiding this comment

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

is a question mark in this and the next heading a strict requirement? not having one will maintain consistency.

@samhita-alla
Copy link
Contributor

overall, the readme looks great! thanks for working on this, David!

Copy link
Contributor

@eapolinario eapolinario left a comment

Choose a reason for hiding this comment

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

This is great!

@davidmirror-ops davidmirror-ops merged commit cb37291 into flyteorg:master Jan 2, 2024
45 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size:L This PR changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants