aturon / aturon.github.io Goto Github PK

The blog here: https://aturon.github.io/blog/

Has different dates for the posts compared to the RSS feed here: https://aturon.github.io/blog/atom.xml

It's making things look quite odd (and confusing) in my RSS reader.

I guess it only happens to the unlucky, but a few find stability-dashboard 's outdated rust docs and don't see that it's out of date or unofficial.

The Realworld implementation in Rust references aturon.github.io/README.md.

It returns 404 now. It had a book called Rust Guidelines before that.

Are those guidelines still available anywhere? Is there a better alternative? Or should they perhaps just remove the link completely?

With a friend of mine, we are coding in rust and we don't know if we should write documentation this way :

/// documentation
fn myfn() {
}

or this way :

/// documentation

fn myfn() {
}

This may seems silly, but you know, choosing style guideline always end up in holy war.

The body text disappeared from http://aturon.github.io/blog/2017/02/06/specialization-and-coherence/, though it is at http://aturon.github.io/2017/02/06/specialization-and-coherence/ . I don't see any other obvious ones missing from ebd9086 .

I really enjoyed the listening and trust series, but it appears the pages have been moved and the links are now broken.

@aturon: https://aturon.github.io/ownership/builders.html claims, that non-consuming builder pattern works with the _one-liner-pattern. I think this is wrong - the following code does not compile (copy-paste this to https://play.rust-lang.org/)

#[derive(Debug, Default)]
struct Channel {
    special_info: i32
}

impl Channel {
    fn special_info<VALUE: Into<i32>>(&mut self, value: VALUE) -> &mut Self {
        self.special_info = value.into();
        self
    }
}

fn main() {
    let ch = Channel::default().special_info(42);
    println!("{:?}", ch);
}

results in

error: borrowed value does not live long enough
  --> <anon>:14:14
14 |>     let ch = Channel::default().special_info(42);
   |>              ^^^^^^^^^^^^^^^^^^ does not live long enough
note: reference must be valid for the block suffix following statement 0 at 14:49...
  --> <anon>:14:50
14 |>     let ch = Channel::default().special_info(42);
   |>                                                  ^
note: ...but borrowed value is only valid for the statement at 14:4
  --> <anon>:14:5
14 |>     let ch = Channel::default().special_info(42);
   |>     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
help: consider using a `let` binding to increase its lifetime
  --> <anon>:14:5
14 |>     let ch = Channel::default().special_info(42);
   |>     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: aborting due to previous error

Therefore I would argue that the consuming-pattern should be the preferred choice to support the one-liner-pattern.

CC @killercup

Currently https://aturon.github.io is the number 1 hit on Google for "rust style guide" but it seems to be an old snapshot. Could this instead point to https://github.com/rust-lang-nursery/fmt-rfcs, so that people would be directed to the latest guidelines?

The documentation at https://aturon.github.io/style/naming/containers.html:

For Result<V, E>:

// Extract the contents of Ok variant; fail if Err
fn assert(self) -> V

// Extract the contents of Err variant; fail if Ok
fn assert_err(self) -> E

This is out of date, according to the documentation of std and IRC conversation.

It looks like static.rust-lang.org can now be accessed with HTTPS, so this should be done.

Should be a one character change here: https://github.com/aturon/aturon.github.io/blob/master/rust-book.css#L2.

I can find this via search engine https://aturon.github.io/ownership/builders.html
but it's 404

A Google search for "Rust naming conventions" returns https://aturon.github.io/style/naming.html as the top hit. But this is a three-year-old snapshot; it would be much better for people to refer to https://rust-lang-nursery.github.io/api-guidelines/naming.html which is current.

Is there any chance you could retire this snapshot, or at least add pointers to more recent docs?

Thanks!