Posts by Jeremiah Peschka

Rust Doc Days Follow Up

A few weeks ago, I mentioned Rust Doc Days. This was an event where the Rust community made a conscious effort to improve Rust’s documentation. Throughout this blog post, “we” refers to the quasi-official Rust docs team. How did it go? The first Rust Doc Days was, we felt, a successful event. We deliberately kept the event low…
Read More

Whatever Comes Next

One of the most exciting things about the last few months has been having time to think about what I want to be when I grow up. I kicked around a bunch of different ideas like “Fallout 4 expert” and a bunch of other fun sounding but impractical ideas. None of them seemed to fit.…
Read More

Announcing Rust Doc Days

Documentation is an important, but overlooked, part of programming. While we can’t make you write documentation, we’re hoping that we can help you remember that good documentation means people are more likely to use the tools that you build. To that point, we (the quasi-official Rust docs team) have organized Rust Doc Days. Writing documentation…
Read More

Writing Documentation in Rust

Documentation is important. It’s also easy to do. Rust ships with tools to help developers create documentation for their libraries. Code Comments The main way that many developers write documentation is through source code comments. A single-line comment in Rust is started with //. Many programming languages should already use this construct, so it’s probably…
Read More

The State of Rust Docs

Every week I hop on IRC and meet with an unofficial Rust documentation team. Our goal is to take a look at documentation across the Rust ecosystem and to figure out how to improve the general state of things. Our work covers a lot of space and includes documentation tooling, centralized documentation, and reviewing the…
Read More

Hijacking stderr in Rust

Liberate your output pipes from the tyranny of programmatic control! Let’s say you have to work with OS processes – you’re building tools for automation and you need to capture the output of a command with your Rust program. You might need to process the command’s output and do something with it, but you also…
Read More

Talking About Rust’s Traits

We previously talked about The Basics of Rust structs. That was some pretty cool stuff – we learned how to structure data and how to attach functionality to that data by using impl. A struct defines what data we have, but what if we want to define how that data should function? Using the traits…
Read More

The Basics of Rust Structs

Pretty structs, as far as the eye can see… structs are one of the basic building blocks in Rust. A struct lets us create more complex data types of our own. Instead of having to jump through naming hoops to make our own data structures, we can create whatever we want. Our First Rust struct…
Read More

Staying Active

Staying active is important. It helps keep you limber. I do two things to stay active. This is active, right? Physical Activity I try to go to the gym 5 times a week. I’m in good shape unless you’re comparing me to Silly Putty, but going to the gym 5 times a week helps me work…
Read More
Menu