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

docs: improve the hello world tutorial #107

Merged
merged 1 commit into from
Oct 11, 2023
Merged

docs: improve the hello world tutorial #107

merged 1 commit into from
Oct 11, 2023

Conversation

joshka
Copy link
Member

@joshka joshka commented Oct 10, 2023

  • Remove the excess side quests and information in the tutorial (e.g.
    rustup, LICENSE / README, release compilation, backend choice,
    specific ratatui versions).
  • add imports and 4 character indents so that the code is more idiomatic
  • add simple explanations about the sections of the code
  • fix heading size (h2 not h3)
  • add a code folder to contain tutorial code which is imported rather
    than included in the tutorial itself

TODO:

  • fix windows reset command
  • update tutorial image

@joshka joshka requested a review from kdheepak October 10, 2023 07:59
@github-actions
Copy link

github-actions bot commented Oct 10, 2023

PR Preview Action v1.4.4
Preview removed because the pull request was closed.
2023-10-11 01:20 UTC

@joshka joshka force-pushed the improve-hello-world branch from dc9d96a to 0a737f0 Compare October 10, 2023 08:02
@joshka
Copy link
Member Author

joshka commented Oct 10, 2023

hello

@joshka
Copy link
Member Author

joshka commented Oct 10, 2023

hello

@joshka joshka force-pushed the improve-hello-world branch 2 times, most recently from 55c6e17 to f453af3 Compare October 10, 2023 08:30
@kdheepak
Copy link
Contributor

I love it! Thanks for the making the hello world tutorial so much nicer. I think this will be a improvement for those new to rust and ratatui.

Copy link
Contributor

Choose a reason for hiding this comment

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

I like the idea of having all the code in a top level folder. This is not what is currently done in the rest of the book. I think we should move all the code to the way you've structured it in this PR. Probably a good first issue.

Copy link
Member Author

Choose a reason for hiding this comment

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

I think ideally we'd have a workspace at the root. That way we can build all sources with cargo build. I didn't want to shift things too much in this PR though.

@kdheepak
Copy link
Contributor

Feel free to merge when you think it is ready!

- Remove the excess side quests and information in the tutorial (e.g.
  rustup, LICENSE / README, release compilation, backend choice,
  specific ratatui versions).
- add imports and 4 character indents so that the code is more idiomatic
- add simple explanations about the sections of the code
- fix heading size (h2 not h3)
- add a `code` folder to contain tutorial code which is imported rather
  than included in the tutorial itself
- update images to match the new code

TODO:
- fix windows reset command
@joshka joshka force-pushed the improve-hello-world branch from f453af3 to 87456d7 Compare October 11, 2023 01:18
@joshka joshka merged commit 1f5de51 into main Oct 11, 2023
2 checks passed
@joshka joshka deleted the improve-hello-world branch October 11, 2023 01:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants