Merge Publications into About Implementation Plan

Merge Publications into About Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Display all publication entries on the About page and remove the Research/Publications link from the main navigation while preserving the standalone Publications source page.

Architecture: This is a source-content change in the existing Jekyll site. The Publications page body is copied into the About page, while the navigation data removes only the /publications/ entry; a small PowerShell regression test checks these source-level guarantees before the full Jekyll build.

Tech Stack: Jekyll, Markdown, YAML, PowerShell


Task 1: Add a failing source-content regression test

Files:

  • Create: test/publications-on-about.tests.ps1
  • Inspect: _pages/about.md
  • Inspect: _pages/publications.md
  • Inspect: _data/navigation.yml

  • Step 1: Write the failing test

Create test/publications-on-about.tests.ps1 with:

$ErrorActionPreference = 'Stop'

$about = Get-Content -Raw '_pages/about.md'
$publications = Get-Content -Raw '_pages/publications.md'
$navigation = Get-Content -Raw '_data/navigation.yml'

if ($about -notmatch '(?m)^## Publications$') {
    throw 'About page does not contain the Publications section.'
}

if ($about -notmatch '(?m)^## Working Papers$') {
    throw 'About page does not contain the Working Papers section.'
}

if ($navigation -match '(?m)^\s+url:\s*/publications/\s*$') {
    throw 'Main navigation still links to /publications/.'
}

if ($publications -notmatch '(?m)^permalink:\s*/publications/\s*$') {
    throw 'The standalone Publications page was removed or its permalink changed.'
}

Write-Output 'Publications/About source checks passed.'
  • Step 2: Run the test to verify it fails

Run:

powershell -NoProfile -ExecutionPolicy Bypass -File test/publications-on-about.tests.ps1

Expected: non-zero exit with About page does not contain the Publications section.

  • Step 3: Commit the regression test
git add test/publications-on-about.tests.ps1
git commit -m "test: cover publications on about page"

Task 2: Merge the content and hide the navigation entry

Files:

  • Modify: _pages/about.md
  • Modify: _data/navigation.yml
  • Preserve unchanged: _pages/publications.md
  • Test: test/publications-on-about.tests.ps1

  • Step 1: Append the Publications page body to About

Append everything from the first ## Publications heading through the final working-paper entry in _pages/publications.md to the end of _pages/about.md. The exact transformation is:

$about = Get-Content -Raw '_pages/about.md'
$publicationsPage = Get-Content -Raw '_pages/publications.md'
$sectionStart = $publicationsPage.IndexOf('## Publications')
if ($sectionStart -lt 0) {
    throw 'Publications heading was not found.'
}
$publicationBody = $publicationsPage.Substring($sectionStart).TrimEnd()
$mergedAbout = $about.TrimEnd() + "`r`n`r`n" + $publicationBody + "`r`n"

Apply the resulting $mergedAbout content to _pages/about.md without changing _pages/publications.md. This direct substring copy preserves names, punctuation, ordering, and status text.

  • Step 2: Remove the Research navigation item

Change _data/navigation.yml from:

main:
  - title: "Research"
    url: /publications/

  - title: "Misc"
    url: /Misc/

to:

main:
  - title: "Misc"
    url: /Misc/

Keep the Contact item and all unrelated spacing/content intact.

  • Step 3: Run the source-content test to verify it passes

Run:

powershell -NoProfile -ExecutionPolicy Bypass -File test/publications-on-about.tests.ps1

Expected: exit code 0 and Publications/About source checks passed.

  • Step 4: Confirm the standalone Publications file is unchanged

Run:

git diff --exit-code -- _pages/publications.md

Expected: exit code 0 with no output.

  • Step 5: Commit the site change
git add _pages/about.md _data/navigation.yml
git commit -m "feat: show publications on about page"

Task 3: Verify the generated site

Files:

  • Verify: _pages/about.md
  • Verify: _data/navigation.yml
  • Verify: _pages/publications.md

  • Step 1: Run the complete Jekyll build

Run:

bundle exec jekyll build --config _config.yml,_config.dev.yml

Expected: exit code 0 and a completed build with no fatal error.

  • Step 2: Re-run the regression check

Run:

powershell -NoProfile -ExecutionPolicy Bypass -File test/publications-on-about.tests.ps1

Expected: exit code 0 and Publications/About source checks passed.

  • Step 3: Inspect the final diff

Run:

git diff --check
git status --short

Expected: no whitespace errors; only intentionally uncommitted build artifacts, if the project generates any, may appear.