docs(tutorials): reorganize the "Getting started" tab #10936
Conversation
github-actions
bot
added
docs
There was a problem hiding this comment.
As explained in #10932, the Flink tutorial failed at some point. To re-generate the output, I had to cheat a little and use copy=True (without committing the change). Given that the results were correct, and that the tutorial is already broken on main, that seemed like an acceptable shortcut to me for this PR.
| ).agg( | ||
| user_mean_trans_amt_last_360min=windowed_stream.amt.mean(), | ||
| user_trans_count_last_360min=windowed_stream.amt.count(), | ||
| user_mean_trans_amt_last_360min=ibis._.amt.mean(), |
There was a problem hiding this comment.
Conflicted with for _, msg in zip(range(10), consumer):
| @@ -23,10 +23,10 @@ ibis.options.interactive = True # <2> | |||
|
|
|||
| load_dotenv() # <3> | |||
|
|
|||
| user = os.getenv("USERNAME") # <4> | |||
There was a problem hiding this comment.
"USERNAME" conflicted with my Linux user. Using prefixed environment variables seemed more robust to me anyway.
| @@ -135,19 +135,9 @@ ibis/examples/descriptions | |||
| ci/odbc/odbc.ini | |||
| *-citibike-tripdata.tar.xz | |||
|
|
|||
| # data downloaded by the geospatial tutorial | |||
| docs/posts/ibis-duckdb-geospatial/nyc_data.db.wal | |||
There was a problem hiding this comment.
Good idea moving all this stuff into a docs/.gitignore. I definitely forget about simple solutions to .gitignore sprawl!
| - auto: tutorials/cloud-data-platforms | ||
| - auto: tutorials/open-source-software | ||
| - tutorials/browser/repl.qmd | ||
| - section: Coming from |
There was a problem hiding this comment.
How do you feel about
Coming from …
with the horizontal ellipsis?
| @@ -1,5 +1,5 @@ | |||
| --- | |||
| title: JupyterLite console | |||
| title: Try it online | |||
There was a problem hiding this comment.
How about
Online playground
?
Or if we keep Try it online can we add an exclamation mark at the end?
Description of changes
Reorganizes the "Getting started" tab layout according to discussions in #8197.
This required re-running most tutorials, and fixing a couple of issues on the way - see comments.
Links and redirections were updated to match the new structure - hopefully I haven't missed any!
I can easily split the PR into smaller ones if it makes the review easier.
Comparison
Choices
I've tried to reach a layout that makes sense for new users (including myself). Some choices that differ from previous discussions:
I'm still new to Ibis, so let me know if other names would be more appropriate!
Issues closed