From 73b4661ce1473631711b14bb9ac66ace64973296 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Sat, 23 Mar 2024 17:59:30 +0900
Subject: [PATCH 1/9] Fix link to "Entropy (information theory)" Wikipedia
entry
Make "Entropy and information theory" inline link compatible with older markdown implementations.
fixes #2565
Newer Markdown implementations (e.g. GitHub's as of this writing) properly render an inline link[0] whose link destination[1] includes parenthesis. Older ones fail, and, as a result, what should be rendered as:
href="https://en.wikipedia.org/wiki/Entropy_(information_theory)"
is instead rendered as:
href="https://en.wikipedia.org/wiki/Entropy_(information_theory"
(closing parenthesis elided/wrong URL)
Wrapping the link destination within angle brackets solves that issue in a way that should be forward-compatible.
[0] https://spec.commonmark.org/0.31.2/#inline-link
[1] https://spec.commonmark.org/0.31.2/#link-destination
---
.../content/en/coding-introduction/sections/further-reading.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md b/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
index 8d3fa0fd21..c941581ff8 100644
--- a/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
+++ b/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
@@ -5,7 +5,7 @@ James Gleick's book [The Information: A History, a Theory, a Flood](http://www.a
## Useful links
- A good collection of resources related to all three kinds of coding is available in the [Bletchley Park Codes Resources](http://www.cimt.org.uk/resources/codes/)
-- [Entropy and information theory](https://en.wikipedia.org/wiki/Entropy_(information_theory))
+- [Entropy and information theory](<https://en.wikipedia.org/wiki/Entropy_(information_theory)>)
- [History of information theory and its relationship to entropy in thermodynamics](https://en.wikipedia.org/wiki/History_of_entropy#Information_theory)
- [Timeline of information theory](https://en.wikipedia.org/wiki/Timeline_of_information_theory)
- [Shannon's seminal work in information theory](https://en.wikipedia.org/wiki/A_Mathematical_Theory_of_Communication)
From e36cc58b0736da358ee8406e396da779fa05e77d Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Thu, 28 Mar 2024 14:32:57 +0900
Subject: [PATCH 2/9] Update contributors.html
---
csfieldguide/templates/appendices/contributors.html | 1 +
1 file changed, 1 insertion(+)
diff --git a/csfieldguide/templates/appendices/contributors.html b/csfieldguide/templates/appendices/contributors.html
index d17a38dfc2..6319a043a8 100644
--- a/csfieldguide/templates/appendices/contributors.html
+++ b/csfieldguide/templates/appendices/contributors.html
@@ -167,6 +167,7 @@ <h2 id="community-contributors"><a href="#community-contributors">{% trans 'Comm
<li><a href="https://github.com/wolginm">wolginm</a> (Mark Wolgin)</li>
<li><a href="https://github.com/michaelmcleodnz">michaelmcleodnz</a> (Michael McLeod)</li>
<li><a href="https://github.com/CyberFlameGO">CyberFlameGO</a> (Aaron Lowe)</li>
+ <li><a href="https://https://github.com/mckzm">mckzm</a></li>
</ul>
<p>{% trans '<strong>Note:</strong> If there is an error in the list, please contact <a href="mailto:jack.morgan@canterbury.ac.nz">Jack Morgan</a>' %}</p>
From 67e0372d14118a0a6db6634e9664a308751a4493 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 11:18:10 +0900
Subject: [PATCH 3/9] Update further-reading.md
Switch link to Wikipedia's "Entropy (information theory)" page to use percent encoding for the inner parens:
%28 for opening paren: (
%29 for closing paren: )
---
.../content/en/coding-introduction/sections/further-reading.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md b/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
index c941581ff8..9fa3117c02 100644
--- a/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
+++ b/csfieldguide/chapters/content/en/coding-introduction/sections/further-reading.md
@@ -5,7 +5,7 @@ James Gleick's book [The Information: A History, a Theory, a Flood](http://www.a
## Useful links
- A good collection of resources related to all three kinds of coding is available in the [Bletchley Park Codes Resources](http://www.cimt.org.uk/resources/codes/)
-- [Entropy and information theory](<https://en.wikipedia.org/wiki/Entropy_(information_theory)>)
+- [Entropy and information theory](https://en.wikipedia.org/wiki/Entropy_%28information_theory%29)
- [History of information theory and its relationship to entropy in thermodynamics](https://en.wikipedia.org/wiki/History_of_entropy#Information_theory)
- [Timeline of information theory](https://en.wikipedia.org/wiki/Timeline_of_information_theory)
- [Shannon's seminal work in information theory](https://en.wikipedia.org/wiki/A_Mathematical_Theory_of_Communication)
From 8b9731562c0d1c3ec1fabf500bd8c71b0a0ea303 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 11:38:19 +0900
Subject: [PATCH 4/9] Update the-parity-magic-trick.md
Update [Parity](https://en.wikipedia.org/wiki/Parity_(mathematics)) to use percent encoding for the inner parens.
---
.../en/coding-error-control/sections/the-parity-magic-trick.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/coding-error-control/sections/the-parity-magic-trick.md b/csfieldguide/chapters/content/en/coding-error-control/sections/the-parity-magic-trick.md
index 865631c6ed..430a9ffa5d 100644
--- a/csfieldguide/chapters/content/en/coding-error-control/sections/the-parity-magic-trick.md
+++ b/csfieldguide/chapters/content/en/coding-error-control/sections/the-parity-magic-trick.md
@@ -56,7 +56,7 @@ The original 7x7 cards that the computer laid out for you could be some kind of
Although they are laid out in a grid, on a computer the rows of bits would be stored or transmitted one after the other (as 8 lots of 8 bits).
The extra cards you added are called *parity bits*.
-[Parity](https://en.wikipedia.org/wiki/Parity_(mathematics))
+[Parity](https://en.wikipedia.org/wiki/Parity_%28mathematics%29)
simply means whether a number is even or odd (the word comes from the same root as "pair").
By adding the extra cards in a way that ensured an even number of black cards in each row and column, you made it so that the rows and columns had what is called *even parity*.
From 3bc7dd173c5f90bf0f2c13618914fa668616bb84 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 11:40:40 +0900
Subject: [PATCH 5/9] Update further-reading.md
Update [Wikipedia – Abstraction](https://en.wikipedia.org/wiki/Abstraction_(computer_science)) to use percent encoding for the inner parens
---
.../content/en/software-engineering/sections/further-reading.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md b/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
index 7753720d01..1c0b212555 100644
--- a/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
+++ b/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
@@ -6,7 +6,7 @@
- [Wikipedia – Software crisis](https://en.wikipedia.org/wiki/Software_crisis)
- [IEEE – Why software fails](http://spectrum.ieee.org/computing/software/why-software-fails)
- [Wikipedia – Software design](https://en.wikipedia.org/wiki/Software_design)
-- [Wikipedia – Abstraction](https://en.wikipedia.org/wiki/Abstraction_(computer_science))
+- [Wikipedia – Abstraction](https://en.wikipedia.org/wiki/Abstraction_&28computer_science%29)
- [Wikipedia – Software testing](https://en.wikipedia.org/wiki/Software_testing)
- [Wikipedia – Software development process](https://en.wikipedia.org/wiki/Software_development_process)
- [Wikipedia – Waterfall model](https://en.wikipedia.org/wiki/Waterfall_model)
From 9e91879f1cf9b1f02a5217e8ed024af483fbbdc5 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 11:43:38 +0900
Subject: [PATCH 6/9] Update other-intractable-problems.md
Update [The Battleship problem](https://en.wikipedia.org/wiki/Battleship_(puzzle)) to use percent encoding for the inner parens
---
.../sections/other-intractable-problems.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/complexity-and-tractability/sections/other-intractable-problems.md b/csfieldguide/chapters/content/en/complexity-and-tractability/sections/other-intractable-problems.md
index fe4b883771..87804eb014 100644
--- a/csfieldguide/chapters/content/en/complexity-and-tractability/sections/other-intractable-problems.md
+++ b/csfieldguide/chapters/content/en/complexity-and-tractability/sections/other-intractable-problems.md
@@ -19,4 +19,4 @@ Extra sections will eventually be added here to introduce some of them, but in t
- [Longest path](https://en.wikipedia.org/wiki/Longest_path) (this is interesting because finding the longest path is intractable, yet finding the shortest path is tractable - the shortest path is calculated when a GPS device works out the shortest route to a destination.
Also, a Hamiltonian problem can be reduced easily to longest path, showing the concept of reduction when one NP-complete problem is used to solve another).
[Here's a song about it!](https://www.youtube.com/watch?feature=player_embedded&v=a3ww0gwEszo)
-- [The Battleship problem](https://en.wikipedia.org/wiki/Battleship_(puzzle))
+- [The Battleship problem](https://en.wikipedia.org/wiki/Battleship_%28puzzle%29)
From 9351fe4034eb8abf3d480e532d683a7322845cf3 Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 11:49:28 +0900
Subject: [PATCH 7/9] Update analysis.md
Update [graph](https://en.wikipedia.org/wiki/Graph_(discrete_mathematics)) to use percent encoding for the inner parens
---
csfieldguide/chapters/content/en/big-data/sections/analysis.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/big-data/sections/analysis.md b/csfieldguide/chapters/content/en/big-data/sections/analysis.md
index 5c8d260cd3..7ebe7cb6df 100644
--- a/csfieldguide/chapters/content/en/big-data/sections/analysis.md
+++ b/csfieldguide/chapters/content/en/big-data/sections/analysis.md
@@ -73,7 +73,7 @@ Here are two prominent examples:
- This is used for investigating social structures using networks.
You can imagine how this works by thinking about the structure of Facebook.
You and everyone else on Facebook are each an individual node, and two people are connected by an edge if they are Facebook friends.
-Together, these nodes and edges make a graph structure (a different type of [graph](https://en.wikipedia.org/wiki/Graph_(discrete_mathematics)) to the ones you normally see in maths) that can be analysed.
+Together, these nodes and edges make a graph structure (a different type of [graph](https://en.wikipedia.org/wiki/Graph_%28discrete_mathematics%29) to the ones you normally see in maths) that can be analysed.
{image file-path="img/chapters/social-network-graph.png" caption="true" alt="Five circles with different names in them are shown with lines connecting each of them to illustrate that they are connected on social media. Each of these circles is then connected to several smaller circles, which represent other friends in their network."}
From d04fbfeee81ea1eb597950366d3310d27868ab5b Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 12:08:05 +0900
Subject: [PATCH 8/9] Update further-reading.md
Update [Ray tracing on Wikipedia](https://en.wikipedia.org/wiki/Ray_tracing_(graphics)) to percent encode the inner parens
---
.../content/en/computer-graphics/sections/further-reading.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/computer-graphics/sections/further-reading.md b/csfieldguide/chapters/content/en/computer-graphics/sections/further-reading.md
index b33c552466..fb21af3beb 100644
--- a/csfieldguide/chapters/content/en/computer-graphics/sections/further-reading.md
+++ b/csfieldguide/chapters/content/en/computer-graphics/sections/further-reading.md
@@ -3,5 +3,5 @@
- [Computer graphics on Wikipedia](https://en.wikipedia.org/wiki/Computer_graphics)
- [Transformation matrix on Wikipedia](https://en.wikipedia.org/wiki/Transformation_matrix)
- [Bresenham's line algorithm on Wikipedia](https://en.wikipedia.org/wiki/Bresenham%27s_line_algorithm)
-- [Ray tracing on Wikipedia](https://en.wikipedia.org/wiki/Ray_tracing_(graphics))
+- [Ray tracing on Wikipedia](https://en.wikipedia.org/wiki/Ray_tracing_%28graphics%29)
- [3D tutorials from POV-Ray](http://www.povray.org/resources/links/3D_Tutorials/POV-Ray_Tutorials/)
From ba48cc38048530744c409f1f25f71cedf1ec289a Mon Sep 17 00:00:00 2001
From: mckzm <134839822+mckzm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 12:54:51 +0900
Subject: [PATCH 9/9] Update further-reading.md
Fix typo in percent encoding: &28 -> %28
---
.../content/en/software-engineering/sections/further-reading.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md b/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
index 1c0b212555..eefb3c0d65 100644
--- a/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
+++ b/csfieldguide/chapters/content/en/software-engineering/sections/further-reading.md
@@ -6,7 +6,7 @@
- [Wikipedia – Software crisis](https://en.wikipedia.org/wiki/Software_crisis)
- [IEEE – Why software fails](http://spectrum.ieee.org/computing/software/why-software-fails)
- [Wikipedia – Software design](https://en.wikipedia.org/wiki/Software_design)
-- [Wikipedia – Abstraction](https://en.wikipedia.org/wiki/Abstraction_&28computer_science%29)
+- [Wikipedia – Abstraction](https://en.wikipedia.org/wiki/Abstraction_%28computer_science%29)
- [Wikipedia – Software testing](https://en.wikipedia.org/wiki/Software_testing)
- [Wikipedia – Software development process](https://en.wikipedia.org/wiki/Software_development_process)
- [Wikipedia – Waterfall model](https://en.wikipedia.org/wiki/Waterfall_model)