Fix aliases documentation and incorporate more feedback from 'Brunch and learn' session on the topic

[jdbaldry]

• Fix bad example
• Emphasize that the current directory is the directory containing the page, not the directory of the page
• Use more easily understood terminology in table demonstration

[github-actions]

Overall readability score: 60.84 (🟢 +0.07)

File	Readability
index.md	71.37 (🟢 +2.85)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
index.md	71.37	56.86	8.6	9.6	10.43	6.63
	🟢 +2.85	🟢 +8.26	🟢 +0.19	🟢 +0.2	🟢 +0.41	🟢 +0.09

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	60.84	47.79	9.57	11.6	12.06	7.31
	🟢 +0.07	🟢 +0.19	🟢 +0	🟢 +0	🟢 +0.01	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[JStickler]

A couple of suggestions that follow up on how we talked about how this is similar to using cd in the meeting the other day.

[JStickler]

Suggested change

	- The current directory element (`.`) refers to the directory containing the current page, _not_ the directory of the current page.
	- The current directory element (`.`) refers to the parent directory of the current page, _not_ the directory that contains the current page. An easy way to remember is that one dot means you have moved one step back in the file path to the page.

[jdbaldry]

I think we should avoid "easy" if possible (https://developers.google.com/style/word-list#easy).

My only concern with this tip is that it is only true at the start of the alias, and that's really because the starting directory for any alias is the directory containing the current page.

I'm worried people will internalize . goes back one part and .. goes back two when in actually . goes nowhere and .. goes back one part.

[JStickler]

Ah, good point about "easy".

Describing how aliases work is hard!

[JStickler]

Suggested change

	- The parent directory element (`..`) refers to the parent directory of the current directory element.
	- The parent directory element (`..`) refers to the parent directory of the current directory element. An easy way to remember is that two dots means you have moved two steps back in the file path to the page.

[JStickler]

Suggested change

	The following table demonstrates how to redirect **FROM PAGE**, to **TO PAGE**.
	In the following table, the **FROM PAGE** column lists the page that requires a redirect, for example because the page has been moved or no longer exists. The **TO PAGE** is where we want to redirect them, for example the renamed page or where the content has been moved.
	The third column shows the alias that should be added to the front matter of the file in the **TO PAGE** column to create the proper redirect.

[jdbaldry]

I like this suggestion but do we need to avoid the use of "we"?

[JStickler]

I don't think so.

[jdbaldry]

I've attempted to rewrite this bit using a list of the columns and your suggestions for explaining each column in 462fe21

[jdbaldry]

Gonna get this in to make sure the example is no longer broken but happy to accept additional contributions in follow up PRs.