80

The Rust programming language () is approaching the 1.0 release soon.

(Who am I? Huon Wilson, member of the Rust core team, and the current top user for .)

This release comes after a long period of pre-alpha, alpha, and (soon) beta development in public. Along the way, there have been huge changes to the language and library, meaning that it is very likely that code from 6 months ago (let alone 3 years) won't compile with a current compiler, or with the 1.0 release. In fact, there have been many major fundamental changes so even the concepts in many of the older answers are now irrelevant e.g. the oldest question tagged [rust] refers to a feature that used to be one of the major draw-cards of Rust, but no longer exists in the language at all.

These changes have caused endless difficulties for beginners trying to learn Rust: code that is outdated and irrelevant doesn't help. This is of course a general problem with Rust code on the internet, in blogs posts etc, but SO is a big source of help to many people, and the outdated code in is something we can possible tackle.

Much of the active Rust community (e.g. people on IRC, publishing on crates.io) run the current nightlies, and there's not many active users of even the most recent release (alpha-2), let alone older releases. This will hold true at 1.0: people will move to either the stable 1.0 release or the post-1.0 nightlies. It is very unlikely that anyone will be trying to actively use older versions of the compiler. The point being: out-dated answers won't help Rust users after 1.0, and are actively unhelpful for new users.

proposal

I would like to give incoming users more help to avoid being tricked by old answers. I propose that

  • questions and (accepted) answers with a small number of upvotes are edited to include a generic message at the top. Something along the lines of

    This [question/answer] relates to a pre-1.0 version of Rust; it may be too old to be helpful.

    (NB. this message was inserted automatically for the lead-up to Rust 1.0. [link to more info].)

    In the best case, this would be done with automation, but I guess it's not out of the question for it to be done manually by a dedicated group of volunteers.

  • more popular questions/answers get special attention, either inserting a more specific message like the above, and/or carefully updating the post to ensure that the correct modern way is clear e.g. linking to a newer question/answer that solves the problem (including possibly creating that answer, by posting a new answer to the same question), or editing the content in the accepted answer (especially if only a few minor code changes are required).

There is a lot of space for finessing exactly how this is done. I am currently thinking that we might do the above to the ~40% of posts that are older than 6 months soon, and then the more recent posts closer to 1.0 (possibly in several stages). Similarly, the thresholds for popularity are pretty loose; I'm thinking questions with 3 or more upvotes, or questions with accepted answers with 5 or more upvotes, but that still leaves several hundred posts to consider.

Is this at all reasonable? If so, what is the best way to accomplish it? Are there alternate ways to solve the fundamental problem that work too?

analysis

Using upvotes as a proxy for how popular/useful an answer is (and with some great assistance from @Manishearth) I looked at the distribution of the accepted answers on [rust] questions and the distribution of the questions themselves . It seems that most answers are not very useful: more than 40% have 2 or fewer votes. Similarly, more than half of questions get at most one vote.

10
  • 28
    Editing rusty questions ?
    – user2629998
    Commented Mar 14, 2015 at 12:30
  • 7
    Another potential solution that we can implement today would be to tag all current Rust questions with something like rust-prerelease. That tag wiki could explain the same things. It's not nearly as nice as a big banner though.
    – Shepmaster
    Commented Mar 15, 2015 at 1:02
  • 1
    @Shepmaster I agree that is a sensible addition, but I think it is a little subtle by itself (especially for people unfamiliar with SO's details).
    – huon
    Commented Mar 15, 2015 at 8:01
  • Disclaiming my ignorance, I've never heard of rust (I really mean no offense). So I would disagree with It seems that most answers are not very useful: more than 40% have 2 or fewer votes. Isn't this kind of a inevitable side-effect of a somewhat niche (1700 questions) tag such as [rust]? Wouldn't two votes be considered as acceptably useful? Commented Mar 16, 2015 at 3:24
  • 1
    @FélixGagnon-Grenier, other tags like java, c++, c have a similar distribution. Although, I'm not at all attached to those numbers. The main point of this post is trying to assess a reasonable strategy to mark the huge number of answers as obsolete to avoid confusion, the precise details can be worked out later. :)
    – huon
    Commented Mar 16, 2015 at 4:20
  • @huon-dbaupp: Should we take the opportunity to clean up as well? I am afraid that because of the low bandwidth of Rust questions, a number of duplicates/quasi-duplicates/typos questions may have slipped through. Commented Mar 16, 2015 at 13:57
  • 1
    You could go further than Shepmaster's idea (at least, I think... not familiar enough with retagging details) and actually replace the current rust tag with rust-prerelease or rust-obsolete (or some mixture of both depending on question age), then create a brand new rust tag with no questions on the day of 1.0. Commented Mar 16, 2015 at 23:12
  • @MatthieuM., that would be a nice thing to do, but I think there's probably already enough work here. :)
    – huon
    Commented Mar 17, 2015 at 0:37
  • 2
    I'll selfishly say that I'm not enthusiastic about @Leushenko's idea to retag - I'd rather not lose my status in the Rust tag and be forced to start again ^_^. Simply adding tags avoids that problem.
    – Shepmaster
    Commented Mar 20, 2015 at 1:58
  • I've created rust-obsolete.
    – tshepang
    Commented Apr 20, 2015 at 22:14

3 Answers 3

14

Could version tags not be introduced etc to show the question (and subsequent answers) apply only to a pre beta version of to avoid confusion?

7
  • 2
    I think this is exactly what's intended by the version tags. Make it clear in the tag wiki excerpt that questions asked about rust-0.6 will often not apply to rust-1.0.
    – Joe
    Commented Mar 16, 2015 at 15:51
  • This is effectively what @Shepmaster suggested in the comments, as I said there, I think it would be best combined with another approach since it is quite subtle, especially for people unfamiliar with SO, and, it won't be seen at all by a direct link to an answer. Of course, I'm totally willing to be convinced that it is adequate standalone. :)
    – huon
    Commented Mar 16, 2015 at 22:19
  • @huon-dbaupp And also add a flag like when you add more than one type of SQL to a question you get a small warning box.
    – Matt
    Commented Mar 17, 2015 at 8:36
  • @Matt, that's a good idea too, but I'm most concerned about users coming in from google etc., looking for answers: mistagged questions like that are easier to manage, as they can just be retagged. It'd be great to help as much as possible the "hidden" people who read others' questions, not ask them.
    – huon
    Commented Mar 18, 2015 at 0:56
  • @huon-dbaupp incorrect assumption of tags, I imagine, is common place when "Google users" are reading questions, but thats the nature of a new user. Much like people wanting to "SELECT TOP 1 in Oracle SQL" and coming to the site from a Google search of "SELECT TOP 1 SQL"
    – Matt
    Commented Mar 18, 2015 at 8:34
  • 2
    One issue with specific versions is that a lot of questions don't indicate what version they apply to. We could try to see when each version was released and make a best-guess effort, but it might just be safer to tag everything with a "before 1.0" tag, if we choose this path.
    – Shepmaster
    Commented Mar 20, 2015 at 2:03
  • @Shepmaster Yeh the initial tagging may be difficult, unless the OP and other experts can wade in
    – Matt
    Commented Mar 20, 2015 at 8:32
13

(Disclosure: I'm also an occasional contributor to Rust)

I'd like something to this effect to happen, since this makes a lot of Stack Overflow answers less useful.

The ideal thing to do is to fix all the answers, though.

I think the best way to achieve this is the post notice system.

enter image description here

The only ones in built in the system are these:

enter image description here

Sites have had custom post notices added, though I don't recall any past situation where a rather specific post notice like this was added.

5
  • 8
    Related meta.se post: What is a better way to mark answers as obsolete? Commented Mar 14, 2015 at 18:16
  • 5
    I think this isn't likely to happen, and isn't really the right way to do it. Moderators won't necessarily have the time or the knowledge to mark questions this way. Use the tools we have, which manage perfectly fine for things like php and such which sometimes have significant versions breaks.
    – Joe
    Commented Mar 16, 2015 at 15:53
  • Your declaration should be rather something completely opposite to disclaimer ;o
    – BartoszKP
    Commented Mar 17, 2015 at 9:25
  • @BartoszKP: I assume the term that was intended is "disclosure". (If we both agree, I think that makes it safe to edit)
    – Ben Voigt
    Commented May 24, 2015 at 17:10
  • @BenVoigt Right, done :)
    – BartoszKP
    Commented May 24, 2015 at 22:42
3

I also propose version tags, but instead not be for a specific version, but rather a series. We already have this with python-2.x and python-3.x

I propose tagging things similarly. Have a new rust-0.x and rust-1.x tag, as well as keeping the original rust tag. Go through the rust tag and add rust-0.x tags where it can be easily determined, new questions can optionally append the rust-1.x tag. This would also be useful if eventually there is a rust-2.x in the future

1
  • Maybe SO could add a warning automatically if a question is tagged with a version tag and there are newer/higher version tags available. Whether this is feasible probably depends on how existing versioned tags such as python-2.x are used up to now ...
    – siffiejoe
    Commented May 18, 2015 at 7:10

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .