plabayo / learn-rust-101 Goto Github PK

A guide to aid you in your journey of becoming a Rustacean (Rust developer).

License: MIT License

educational guide learning rust rust-lang track

learn-rust-101's Introduction

ⓘ A guide to aid you in your journey of becoming a Rustacean (Rust developer). See the Contributing and Code of Conduct for more information about how to contribute to this repository.

Disclaimer

This guide is made by Glen De Cauwsemaecker and is in no way endorsed nor affiliated with the Rust foundation. Rust & Cargo are registered trademarks of the Rust foundation.

Sharing is caring

This guide is free and will remain gratis available to share for all who are interested or until the overlords at GitHub pull it down.

🗞 This guide was featured on the front page of HackerNews on the 8th of April 2023 and in the weekly edition of the Rust newsletter on the 12th of April 2023.

Prologue

Rust is a modern systems programming language with safety in mind as one of its core goals and strengths. Systems programming is programming within a resource constrained environment. However, as a lot of our services run now in paid-for-usage cloud environments, we can also consider them as resource constrained environments. This is why Rust is a great fit for more use cases than people might realize.

As it is a modern language and has taken the lessons from many other languages before it, it is also surprisingly pleasant to use once you get the hang of it. Its type system also allows expressive code that can help you exclude a great categories of bugs beyond the benefits that static typing can bring.

The goal of this guide is to introduce Rust to you as an individual or an entire organization. Should this not be sufficient you can also contact me for 1-on-1 coaching or workshops for your organization, by emailing me at [email protected]. More information on Glen can be found at https://glendc.com/.

This guide is fully open source and the complete source code can be found at https://github.com/plabayo/learn-rust-101. If you find any errors or have any suggestions, please open an issue or a pull request. If you want to contribute to this guide, please read the Contributing Guidelines. This guide is licensed under the MIT License and developed with love by Plabayo.

Learning Guide

Source code for this guide is available under ./src.

This is the source code of an mdBook served at https://rust-lang.guide/.

learn-rust-101's People

Contributors

Stargazers

Watchers

Forkers

jondwillis votatdat d-mbithi albe-rosado tamiral ssoq yourabi stmsi fatelei lukemathwalker adethormiwa palash90 louisgariepy mdfad-tech bayareaunicorn kewei-lu

learn-rust-101's Issues

update CI pipeline tech stack (deps) — version updates

setup pipeline + script to create an Kindle Self Publishing file from the website content

Has to take into account extras:

custom order
extra pages
page filtering
page overwrites
cover art

provide Spanish translation for the guide

For now no published version desired, but we will add credits both online and in the English published book.

The online version will be available under https://rust-lang.guide/es/

provide Portuguese translation for the guide

For now no published version desired, but we will add credits both online and in the English published book.

The online version will be available under https://rust-lang.guide/pt/

add all new content that we shared on other channels since first edition

provide French translation for the guide

For now no published version desired, but we will add credits both online and in the English published book.

The online version will be available under https://rust-lang.guide/fr/

Typo in `README.md`

"Prelogue" should be "Prologue".

[community] issue tracker to collect feedback on the current guide

This issue serves as a place to allow anyone from the community to provide feedback that we can then take into account while we work on the second edition of the book. Feedback can just be a comment here, or even a PR on top. But do start with a comment here first so we can make sure to be aligned.

If there is content missing, not well formulated or that should be removed. Let me know.

provide Chinese translation for the guide

For now no published version desired, but we will add credits both online and in the English published book.

The online version will be available under https://rust-lang.guide/zh/

improve prose, layout and general writing of book

add graphics to some pages and cover art for/to book

Crabs and Llamas theme

Consider changing domain from "rust-lang" to something less ambiguous.

Regardless of trademark implications, I find that using "rust-lang" as a domain name implies some form of endorsement from the Project or the Foundation. Moreover, there is a definite element of confusion since Rust's official site also uses the "rust-lang" domain.

Furthermore, considering the guide advertises the author as a consultant and promotes donation links to them, I believe it should make a clear effort to distinguish itself from the official Rust website, and having the same domain name does not go towards that goal.

Do note that I'm not affiliated with the Rust Project and Foundation, I only offer this advice as someone with an interest in Rust learning material.

That said, feel free to close this issue without any changes. If you do, I'd appreciate if you could leave an explanation of your reasoning for keeping the domain name, for posterity.

Thanks.

plabayo / learn-rust-101 Goto Github PK

learn-rust-101's Introduction

Disclaimer

Sharing is caring

Prologue

Learning Guide

learn-rust-101's People

Contributors

Stargazers

Watchers

Forkers

learn-rust-101's Issues

Recommend Projects

Recommend Topics

Recommend Org