book/redirects/functions.md

% Functions

<small>There is a new edition of the book and this is an old link.</small>

> Function definitions in Rust start with `fn` and have a set of parentheses after the function name.
> The curly brackets tell the compiler where the function body begins and ends.
> We can call any function we’ve defined by entering its name followed by a set of parentheses. 

```rust
fn main() {
    println!("Hello, world!");

    another_function();
}

fn another_function() {
    println!("Another function.");
}
```

---

Here are the relevant sections in the new and old books:

* **[In the first edition: Ch 3.2 — Functions][1]**
* <small>[in the current edition: Ch 3.03 — Functions][2]</small>


[1]: https://doc.rust-lang.org/1.30.0/book/first-edition/functions.html
[2]: ch03-03-how-functions-work.html
-												Put the chapter title as the title

And reword the blurb to include what was previously in the title.

This makes it easier to see that one has arrived to the right place:
beforehand, the only indication was through the link target for the
first edition; it was nowhere in the copy itself for most pages.

											
										
										
											2017-12-30 12:00:14 +00:00
+								% Functions
-												add redirects for original book

											
										
										
											2017-03-03 14:50:30 +00:00
-												Highlight recommended path and lowlight the rest

Instead of placing the link to the recommended resource i.e. the second
edition in second place, push it up to the top of the list. In fact,
push the link to the first edition always at the bottom.

To emphasise even more that's where new visitors should go, bolden the
first link, and make the first-ed link smaller.

All this as well as a slight edit and simplification of the copy is
designed to make the new and recommended resources the primary path
readers take, without hiding the old resource completely.

											
										
										
											2017-12-31 03:21:47 +00:00
+								<small>There is a new edition of the book and this is an old link.</small>
-												Add blurb and code example

To improve immediate value and reduce discard-because-not-useful factor
upon arriving at a page which does not contain the content you were
expecting, add a small blurb taken/adapted from the newer source,
optionally accompanied by a code sample describing the feature.

However, due to the transitive nature of this resource, there must be no
content here that isn't available elsewhere.

											
										
										
											2017-12-31 01:56:24 +00:00
 								> Function definitions in Rust start with `fn` and have a set of parentheses after the function name.
 								> The curly brackets tell the compiler where the function body begins and ends.
 								> We can call any function we’ve defined by entering its name followed by a set of parentheses.
 								```rust
 								fn main() {
 								    println!("Hello, world!");
 								    another_function();
 								}
 								fn another_function() {
 								    println!("Another function.");
 								}
 								```
 								---
-												Highlight recommended path and lowlight the rest

Instead of placing the link to the recommended resource i.e. the second
edition in second place, push it up to the top of the list. In fact,
push the link to the first edition always at the bottom.

To emphasise even more that's where new visitors should go, bolden the
first link, and make the first-ed link smaller.

All this as well as a slight edit and simplification of the copy is
designed to make the new and recommended resources the primary path
readers take, without hiding the old resource completely.

											
										
										
											2017-12-31 03:21:47 +00:00
+								Here are the relevant sections in the new and old books:
-												add redirects for original book

											
										
										
											2017-03-03 14:50:30 +00:00
-												Highlight recommended path and lowlight the rest

Instead of placing the link to the recommended resource i.e. the second
edition in second place, push it up to the top of the list. In fact,
push the link to the first edition always at the bottom.

To emphasise even more that's where new visitors should go, bolden the
first link, and make the first-ed link smaller.

All this as well as a slight edit and simplification of the copy is
designed to make the new and recommended resources the primary path
readers take, without hiding the old resource completely.

											
										
										
											2017-12-31 03:21:47 +00:00
+								* **[In the first edition: Ch 3.2 — Functions][1]**
-												Update links in redirects

											
										
										
											2018-12-07 14:56:43 +00:00
+								* <small>[in the current edition: Ch 3.03 — Functions][2]</small>
-												Make explanation on redirect pages shorter to make the links forward obvious


											
										
										
											2017-06-14 18:11:46 +00:00
-												Update links in redirects

											
										
										
											2018-12-07 14:56:43 +00:00
+								[1]: https://doc.rust-lang.org/1.30.0/book/first-edition/functions.html
 								[2]: ch03-03-how-functions-work.html