From 0e352f8a3769e181e6a3ae87fd62e60947b2fef4 Mon Sep 17 00:00:00 2001
From: Bruce Hoppe <behoppe@mit.edu>
Date: Thu, 1 Feb 2024 15:43:41 -0500
Subject: [PATCH 1/4] Rename blog

Change "Fast Code" menu item to "Blog", which appears 4th in main menu
---
 src/_includes/partials/footer.njk             |   2 +-
 src/_includes/partials/sidebar-blog.njk       |   4 +---
 src/_includes/partials/sidebar-toc.njk        |   3 +--
 src/blog.njk                                  |   4 ++--
 src/doc/index.njk                             |   4 ++--
 src/posts/posts.11tydata.js                   |   2 +-
 .../build/html/.doctrees/environment.pickle   | Bin 24936 -> 24936 bytes
 .../docs/build/html/_static/css/custom.css    |   7 +++++++
 src/sphinx/docs/source/_static/css/custom.css |   7 +++++++
 9 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/_includes/partials/footer.njk b/src/_includes/partials/footer.njk
index 4cde87c3..ca27e08a 100644
--- a/src/_includes/partials/footer.njk
+++ b/src/_includes/partials/footer.njk
@@ -5,7 +5,7 @@
     <div class="d-flex mx-4">
       <ul class="list-unstyled text-small">
         <li><a class="link-secondary" href="/doc/users-guide/install">Install</a></li>
-        <li><a class="link-secondary" href="/posts/">Fast code</a></li>
+        <li><a class="link-secondary" href="/posts/">Blog</a></li>
 
       </ul>
     </div>
diff --git a/src/_includes/partials/sidebar-blog.njk b/src/_includes/partials/sidebar-blog.njk
index afb41b19..e8aec1ce 100644
--- a/src/_includes/partials/sidebar-blog.njk
+++ b/src/_includes/partials/sidebar-blog.njk
@@ -1,9 +1,7 @@
-{% set context = 'Fast code' %}
-
 <div class="sidebar-start-items__item">
     <nav class="bd-links" id="bd-docs-nav" aria-label="Section navigation">
         <h5 class="w-100 p-2 rounded" style="margin-left: -0.4em; margin-top: 0; color: var(--midnight); background-color: var(--lime);">
-            {{ context }}
+            {{ metadata.blog.title }}
         </h5>
         {% set postslist = collections.posts %}
         <div class="bd-toc-item navbar-nav">
diff --git a/src/_includes/partials/sidebar-toc.njk b/src/_includes/partials/sidebar-toc.njk
index 6ef3f15c..42935d59 100644
--- a/src/_includes/partials/sidebar-toc.njk
+++ b/src/_includes/partials/sidebar-toc.njk
@@ -1,5 +1,4 @@
-{% set navPages = ['Blog', 'Documentation', 'Community', 'About us', 'Contribute'] %}
-{% if eleventyNavigation.key in navPages %}
+{% if eleventyNavigation.parent == 'Home' %}
 {% set context = eleventyNavigation.key %}
 {% else %}
 {% set context = eleventyNavigation.parent %}
diff --git a/src/blog.njk b/src/blog.njk
index 11ea6145..5c62f63c 100644
--- a/src/blog.njk
+++ b/src/blog.njk
@@ -5,8 +5,8 @@ background: bg-white
 sidebar: blog
 permalink: /posts/
 eleventyNavigation:
-  key: Fast code
-  order: 2
+  key: Blog
+  order: 4
   parent: Home
 ---
 
diff --git a/src/doc/index.njk b/src/doc/index.njk
index cf4d76bf..f811629d 100644
--- a/src/doc/index.njk
+++ b/src/doc/index.njk
@@ -4,12 +4,12 @@ layout: layouts/page.njk
 eleventyNavigation:
   key: Documentation
   parent: Home
-  order: 4
+  order: 2
 ---
 
 <p>You can browse the documentation with our <a href="/tags/">curated tags</a>.</p>
 
-<p>See also our <a href="/posts/">Fast code</a> blog, which puts it all in context with stories about the latest developments in performance engineering.</p>
+<p>See also our <a href="/posts/">blog</a>, which puts it all in context with stories about the latest developments in performance engineering.</p>
 
 <div class="d-flex flex-wrap">
   <div class="flex-fill m-2 p-2 rounded" style="background-color: var(--pst-color-surface); border-left: 0.2rem solid var(--yellow); border-top: 0.2rem solid var(--yellow);">
diff --git a/src/posts/posts.11tydata.js b/src/posts/posts.11tydata.js
index 03982871..4f73e3d9 100644
--- a/src/posts/posts.11tydata.js
+++ b/src/posts/posts.11tydata.js
@@ -2,7 +2,7 @@ module.exports = {
     eleventyComputed: {
       eleventyNavigation: {
         key: data => data.title,
-        parent: 'Fast code'
+        parent: 'Blog'
       },
     }
   };
\ No newline at end of file
diff --git a/src/sphinx/docs/build/html/.doctrees/environment.pickle b/src/sphinx/docs/build/html/.doctrees/environment.pickle
index 3dfb464990c33469d7cc708fb27592c1dfcb68c1..a2338da13a147e3df16869a8ce29c0a1b50dfe08 100644
GIT binary patch
delta 35
pcmaEHi1EcC#tlh|BJ#Z}#AEJcH8U|VxI5ki@g8j7T&DQR9smyV4-NnT

delta 35
qcmaEHi1EcC#tlh|B5XI>ecK$enwc0F+#PQMd44h%H<u}XvIhVPA`XE7

diff --git a/src/sphinx/docs/build/html/_static/css/custom.css b/src/sphinx/docs/build/html/_static/css/custom.css
index 6630a695..fbbd36fa 100644
--- a/src/sphinx/docs/build/html/_static/css/custom.css
+++ b/src/sphinx/docs/build/html/_static/css/custom.css
@@ -13,6 +13,7 @@
   --pst-font-family-heading: var(--pst-font-family-base-system);
   --pst-font-family-monospace: var(--pst-font-family-monospace-system);
 
+  --silk: #d1d6d6;
   --lightgray: #e0e0e0;
   --gray: #C0C0C0;
   --gentlegray: #c8c3bc;
@@ -105,6 +106,12 @@ h2, h3, h4, h5, h6 {
   margin-bottom: 0.4rem;
   padding: 0.2rem 0 0.1rem;
 }
+html[data-theme="dark"] main h2 {
+  color: white;
+  background-color: var(--blue);
+  margin-left: -0.25em;
+  padding-left: 0.25em;
+}
 .bd-header {
   background-color: var(--pst-color-navbar) !important;
 }
diff --git a/src/sphinx/docs/source/_static/css/custom.css b/src/sphinx/docs/source/_static/css/custom.css
index 6630a695..fbbd36fa 100644
--- a/src/sphinx/docs/source/_static/css/custom.css
+++ b/src/sphinx/docs/source/_static/css/custom.css
@@ -13,6 +13,7 @@
   --pst-font-family-heading: var(--pst-font-family-base-system);
   --pst-font-family-monospace: var(--pst-font-family-monospace-system);
 
+  --silk: #d1d6d6;
   --lightgray: #e0e0e0;
   --gray: #C0C0C0;
   --gentlegray: #c8c3bc;
@@ -105,6 +106,12 @@ h2, h3, h4, h5, h6 {
   margin-bottom: 0.4rem;
   padding: 0.2rem 0 0.1rem;
 }
+html[data-theme="dark"] main h2 {
+  color: white;
+  background-color: var(--blue);
+  margin-left: -0.25em;
+  padding-left: 0.25em;
+}
 .bd-header {
   background-color: var(--pst-color-navbar) !important;
 }

From 18ee12817c2892265187dba3b6857ef6fd044fab Mon Sep 17 00:00:00 2001
From: Bruce Hoppe <behoppe@mit.edu>
Date: Thu, 1 Feb 2024 15:44:48 -0500
Subject: [PATCH 2/4] Lighten h2 background

Change h2 background from navy to light gray (in light mode)
---
 src/css/users-guide.css | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/css/users-guide.css b/src/css/users-guide.css
index efdfadf7..50e37075 100644
--- a/src/css/users-guide.css
+++ b/src/css/users-guide.css
@@ -1,7 +1,5 @@
-
 main h2 {
-    color: white;
-    background-color: var(--blue);
+    background-color: #f6f4f4;
     margin-left: -0.25em;
     padding-left: 0.25em;
 }

From 7950b9415122f2381e288d3a90b9c469856991e4 Mon Sep 17 00:00:00 2001
From: Bruce Hoppe <behoppe@mit.edu>
Date: Thu, 1 Feb 2024 15:46:06 -0500
Subject: [PATCH 3/4] Create learn.md

New page on main menu: Learn software performance engineering
---
 src/learn.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 src/learn.md

diff --git a/src/learn.md b/src/learn.md
new file mode 100644
index 00000000..af3e5589
--- /dev/null
+++ b/src/learn.md
@@ -0,0 +1,42 @@
+---
+layout: layouts/page.njk
+background: bg-white
+sidebar: toc
+title: Learn software performance engineering
+eleventyNavigation:
+  key: Learn
+  parent: Home
+  order: 3
+---
+
+We are actively maintaining the following list of resources to help you learn **sofware performance engineering** &mdash; developing fast code for applications that run on modern multicore computers. If you have any questions, comments, or suggested additions, please [let us know](/contribute/contact/).
+
+## Introductory materials
+* [Introduction to Parallel Computing](https://hpc.llnl.gov/documentation/tutorials/introduction-parallel-computing-tutorial): This overview briefly introduces a broad range of topics and concludes with its own list of [recommended reading](https://hpc.llnl.gov/documentation/tutorials/introduction-parallel-computing-tutorial##References). (By Livermore Computing)
+* [Parallel Computing for Beginners](https://www.learnpdc.org/PDCBeginners/): This free on-line textbook is designed to teach early computing students the basics of parallel and distributed computing. (By Joel C. Adams, Richard A. Brown, Suzanne J. Matthews, and Elizabeth Shoop of CSinParallel)
+
+## Tutorials and interactive books
+
+* [Programming Parallel Computers](https://ppc.cs.aalto.fi/): Open online version of the Aalto University course CS-E4580, which teaches how to write fast code for modern computers. (By Jukka Suomela)
+* [Performance Ninja Class](https://github.com/dendibakh/perf-ninja): This 27-module curriculum focuses on low-level performance issues and requires basic C++ skills. (By Denis Bakhvalov)
+* [Intermediate Parallel and Distributed Computing](https://www.learnpdc.org/IntermediatePDC/): This sequel to *Parallel Computing for Beginners* introduces numerous patterns of parallel and distributed computation. (By Elizabeth Shoop)
+* [NERSC training materials](https://www.nersc.gov/users/training/): If you're looking for something specific (as opposed to following a curriculum), check out the archives of past training events hosted here. (For example, here is a [5-part series from 2023](https://www.nersc.gov/users/training/past-training-events/2023/hip-training-series-aug-oct-2023/) about programming GPUs with the HIP parallel computing platform.)
+* [Parallel computing e-book](http://parallel.cs.jhu.edu/index.html): Johns Hopkins course EN 601.420/620, "Parallel computing for data science," includes a [Jupyter-based e-book](https://github.com/randalburns/pcds.2023) that you can install on your local machine.
+
+## Books
+
+### Principles and practice of writing fast code
+
+* [Algorithms for Modern Hardware](https://en.algorithmica.org/hpc/) (2023) by Sergey Slotin
+* [The Art of Multiprocessor Programming](https://www.amazon.com/Art-Multiprocessor-Programming-Maurice-Herlihy/dp/0124159508/) (2021) by Maurice Herlihy, Nir Shavit, Victor Luchangco, and Michael Spear
+* [Performance Analysis and Tuning on Modern CPUs](https://book.easyperf.net/perf_book) (2020) by Denis Bakhvalov
+* [Programming Models for Parallel Computing](https://mitpress.mit.edu/9780262528818/programming-models-for-parallel-computing/) (2015) by Pavan Balaji (ed)
+* [Performance Solutions](http://www.perfeng.com/classic-site/psbook.htm) (2001) by Connie Smith 
+
+### Patterns of parallel programming
+
+* [Structured Parallel Programming: Patterns for Efficient Computation](https://www.amazon.com/Structured-Parallel-Programming-Efficient-Computation/dp/0124159931) (2012) by Michael McCool, James Reinders, and Arch Robison
+* [Patterns of Parallel Programming with .NET](https://download.microsoft.com/download/3/4/D/34D13993-2132-4E04-AE48-53D3150057BD/Patterns_of_Parallel_Programming_CSharp.pdf) (2010) by Stephen Toub
+* [Patterns for Parallel Programming](https://www.amazon.com/Patterns-Parallel-Programming-Software-ebook/dp/B001UG3IQQ) (2004) by Timothy Mattson, Beverly Sanders, and Berna Massingill
+* [Our Pattern Language](https://patterns.eecs.berkeley.edu/) by UC Berkeley
+

From 809a630bc2102e0b341e242ec5b1aec9063c3cfc Mon Sep 17 00:00:00 2001
From: Bruce Hoppe <behoppe@mit.edu>
Date: Thu, 1 Feb 2024 16:08:22 -0500
Subject: [PATCH 4/4] fix typo

---
 src/learn.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/learn.md b/src/learn.md
index af3e5589..38d36364 100644
--- a/src/learn.md
+++ b/src/learn.md
@@ -9,7 +9,7 @@ eleventyNavigation:
   order: 3
 ---
 
-We are actively maintaining the following list of resources to help you learn **sofware performance engineering** &mdash; developing fast code for applications that run on modern multicore computers. If you have any questions, comments, or suggested additions, please [let us know](/contribute/contact/).
+We are actively maintaining the following list of resources to help you learn ***software performance engineering*** &mdash; developing fast code for applications that run on modern multicore computers. If you have any questions, comments, or suggested additions, please [let us know](/contribute/contact/).
 
 ## Introductory materials
 * [Introduction to Parallel Computing](https://hpc.llnl.gov/documentation/tutorials/introduction-parallel-computing-tutorial): This overview briefly introduces a broad range of topics and concludes with its own list of [recommended reading](https://hpc.llnl.gov/documentation/tutorials/introduction-parallel-computing-tutorial##References). (By Livermore Computing)