Skip to content
This repository was archived by the owner on Sep 30, 2020. It is now read-only.

Resolve a number of outstanding FAQ issues #905

Closed
wants to merge 2 commits into from
Closed

Resolve a number of outstanding FAQ issues #905

wants to merge 2 commits into from

Conversation

alilleybrinker
Copy link
Contributor

This resolves a number of the items in #886. In particular:

“Is this project controlled by Mozilla?“

  • Update the number of unique contributors.
  • Should the yearly review cycle be in here?

“In which projects is Mozilla using Rust?“

  • Update to include info about Rust use in Firefox.

“What examples are there of large Rust projects?“

  • See if there are larger projects which could warrant adding.

“How can I try Rust easily?”

  • “playpen” -> “playground”

“How do I get help with Rust issues?”

  • Remove /r/rust, because it’s not an official channel.

“Why has Rust changed so much over time?”

  • Link to Rust’s specific stability policy.

“How fast is Rust?“

  • Include links to more benchmarks and comparisons?

“Why curly braces? Why can’t Rust’s syntax be like Haskell’s or Python’s?”

  • Remove reference to the complexity of the parser in the compiler.

“What is ‘monomorphisation’?“

  • We’re using the UK English spelling here. Do we want to be? Do we have a policy for this?

“What the deal with unwrap() everywhere?“

  • The existence of the ? should probably be mentioned.

“How do I get an error when I try to run example code that uses the try! macro?”

  • The use of try! (and of course ? by extension) inside of main has been accepted as an RFC. This should be mentioned.

@aturon
Copy link
Member

aturon commented Oct 20, 2017

Hi @AndrewBrinker! Sorry this never got followed up on -- we don't have a great review process for the website. Want to rebase, then ping me for review?

@alilleybrinker
Copy link
Contributor Author

Alright, it should be ready to go now. @aturon

Copy link
Member

@Mark-Simulacrum Mark-Simulacrum left a comment

Choose a reason for hiding this comment

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

I think this looks good overall, but left some initial comments.

guiding it from a global perspective. There are also subteams to guide and foster development of particular areas of interest, including the core language, the compiler, Rust libraries, Rust tools, and moderation of the official Rust communities. Designs in each of these areas are advanced through an [RFC process](https://github.com/rust-lang/rfcs). For changes which do not require an RFC, decisions are made through pull requests on the [`rustc` repository](https://github.com/rust-lang/rust).
As far as [project governance](https://github.com/rust-lang/rfcs/blob/master/text/1068-rust-governance.md) goes, Rust is managed by a core team that sets the vision and priorities for the project, guiding it from a global perspective. There are also subteams to guide and foster development of particular areas of interest, including the core language, the compiler, Rust libraries, Rust tools, and moderation of the official Rust communities. Designs in each of these areas are advanced through an [RFC process](https://github.com/rust-lang/rfcs). For changes which do not require an RFC, decisions are made through pull requests on the [`rustc` repository](https://github.com/rust-lang/rust).

Long term planning is guided by a [yearly roadmap](https://github.com/brson/rfcs/blob/north-star/text/0000-north-star.md), with specific milestones set each year.
Copy link
Member

Choose a reason for hiding this comment

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

This should link to the merged RFC instead, which I believe is https://github.com/rust-lang/rfcs/blob/master/text/1728-north-star.md.


<h3><a href="#why-has-rust-changed-so-much" name="why-has-rust-changed-so-much">
Why has Rust changed so much over time?
</a></h3>

Rust started with a goal of creating a safe but usable systems programming language. In pursuit of this goal it explored a lot of ideas, some of which it kept (lifetimes, traits) while others were discarded (the typestate system, green threading). Also, in the run up to 1.0 a lot of the standard library was rewritten as early designs were updated to best use Rust's features and provide quality, consistent cross-platform APIs. Now that Rust has reached 1.0, the language is guaranteed to be "stable"; and while it may continue to evolve, code which works on current Rust should continue to work on future releases.
Rust started with a goal of creating a safe but usable systems programming language. In pursuit of this goal it explored a lot of ideas, some of which it kept (lifetimes, traits) while others were discarded (the typestate system, green threading). Also, in the run up to 1.0 a lot of the standard library was rewritten as early designs were updated to best use Rust's features and provide quality, consistent cross-platform APIs. Now that Rust has reached 1.0, the language is [guaranteed to be "stable"](https://blog.rust-lang.org/2014/10/30/Stability.html); and while it may continue to evolve, code which works on current Rust should continue to work on future releases.
Copy link
Member

Choose a reason for hiding this comment

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

Hm, I'm not sure about putting stable in quotes -- I think linking to the stability policy is good (but I think there's an RFC which covers this better? I wasn't able to quickly find it, but maybe it's https://github.com/rust-lang/rfcs/blob/master/text/1105-api-evolution.md? @aturon can probably help more here...)

@steveklabnik
Copy link
Member

@AndrewBrinker ping! Got anything to say about @Mark-Simulacrum 's comments?

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants