Skip to content

UWTN 2026-012: Benchmarking Stokes Flow in Annulus and Spherical-Shell Geometries - #11

Open
lmoresi wants to merge 5 commits into
mainfrom
note/annulus-spherical-stokes-benchmarks
Open

UWTN 2026-012: Benchmarking Stokes Flow in Annulus and Spherical-Shell Geometries#11
lmoresi wants to merge 5 commits into
mainfrom
note/annulus-spherical-stokes-benchmarks

Conversation

@lmoresi

@lmoresi lmoresi commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Thyagarajulu Gollapalli's benchmark post, converted from
gthyagi/UW3_Annulus_Spherical_Benchmarks.
At review, so the preview picks it up.

His prose is carried over as written. Only the markup is converted — no
edits to wording, structure or claims. If anything reads oddly, it is likely
something I broke rather than something he wrote.

What the conversion did

  • <p align="justify"> wrappers dropped; MyST handles the typography.
  • The HTML <sup> footnote anchors and the hand-written References list
    replaced by real citations and a MyST-generated bibliography. Five entries
    are pinned in references.bib rather than resolved from doi.org at build
    time — UWTN 2026-011 found the hard way that a doi.org hiccup on CI publishes
    a broken citation, and a deposited PDF cannot be repaired.
  • <em>, <sub> and <sup> markup turned into real maths: $L_2$, $q_h$,
    $P_2 \times P_1$, $O(h^2)$, $\sigma_{rr}$, $\Gamma_{\mathrm{inner}}$. The
    ```math blocks became display maths.
  • Nine <img> tags became eight {figure} directives with alt text, plus the
    banner. Alt text is on one line each, because a wrapped directive option
    silently truncates the alt and renders the remainder as a stray caption.

Three decisions worth a second opinion

The banner. The combined analytical-fields image is used as the banner. It
was also a captioned figure in the body, which would render it twice — once
from the injected banner block and once as a figure — so I dropped the in-body
copy and folded its caption into the surrounding text as a sentence. If
gthyagi would rather it stayed a numbered figure, the fix is to give the note a
different banner.

Thieulot & Puckett (2018) has no DOI — it is a preprint cited in the
original by an author-hosted PDF. It is an @unpublished entry carrying that
URL, which is the only persistent handle available.

Metadata I chose, since the source post has none: subjects
mantle-convection, planetary; methods benchmarks-validation, solvers,
finite-elements.

The four linked benchmark article PDFs stay as links to his repository rather
than being copied in.

Underworld development team with AI support from Claude Code

UWTN 2026-012, from
gthyagi/UW3_Annulus_Spherical_Benchmarks/docs/benchmarks_blog_post. His prose
is carried over as written; only the markup is converted.

- <p align="justify"> wrappers dropped, HTML <sup> footnote anchors replaced
  by real citations, and the hand-written References list removed in favour of
  a bibliography MyST generates. Five entries pinned in references.bib rather
  than resolved from doi.org at build time, for the reason UWTN 2026-011 found
  the hard way. Thieulot & Puckett has no DOI, so it is an @Unpublished entry
  with the author-hosted URL.
- <em>/<sub>/<sup> markup turned into real maths: L_2, q_h, P_2 x P_1, O(h^2),
  sigma_rr, Gamma_inner. ```math blocks became display maths.
- Nine <img> tags became eight {figure} directives with alt text on ONE line,
  plus the banner. The combined-fields image is the banner, so the in-body
  copy of it was dropped and its caption folded into the text -- otherwise it
  renders twice, once from the injected banner block and once as a figure.

Underworld development team with AI support from Claude Code
@github-actions

github-actions Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Preview

Or the whole site.

Built from d47c4ab. Shows notes at draft and review, which the published site withholds. Not indexed, no comments, and not the citable version. Confirmed serving this commit before this was posted.

…n the text

Louis's call, and the right way round. The combined analytical-fields image was
serving as the banner, which meant it could not also be a captioned figure
where its author put it -- it would have rendered twice. A photograph in the
header frees the figure to go back to the Benchmark Suite section with the
caption gthyagi wrote for it. Nine figures again.

The banner is credited through banner_credit in metadata.yml, not in the
markdown. Writing the credit into the body does not survive: build-pdf strips
the banner block and build-html regenerates it, so a hand-written credit is
destroyed and replaced by a plain one. banner_credit is the field the
regeneration reads, which is how Unsplash's attribution requirement survives a
rebuild.

Underworld development team with AI support from Claude Code
lmoresi added a commit that referenced this pull request Aug 14, 2026
* News: introduce the Technical Notes

A short post saying what the series is and why it exists: the writing people
want to cite now has a version, an archival PDF and a DOI, and deposit is a
decision rather than a consequence of publishing. Links to the first two notes,
to how to submit, and to the listings.

article_type: news, so it is not archival -- no PDF, no DOI, nothing to
deposit.

ID allocated as 2026-013, not the 2026-012 the script offered: that number is
already taken by gthyagi's note on PR #11, which the allocator cannot see from
this branch because it reads the articles present here.

Underworld development team with AI support from Claude Code

* Revise introduction to technical notes

Updated the introduction to clarify the purpose and format of technical notes, emphasizing their role in documenting measurements and findings.

* Banner for the news post

Photo by Lukas Hron on Unsplash, credited through banner_credit in
metadata.yml.

Underworld development team with AI support from Claude Code

* Update title for Technical Notes article
lmoresi added a commit that referenced this pull request Aug 16, 2026
…cator reissuing a number

UWTN 2026-012 was allocated twice: to the annulus and spherical-shell
benchmarks (#11) and to this note. The benchmarks note claimed it first and
keeps it.

The allocator read only the working tree, so a number claimed by a note in
review on its own branch was invisible to it and was offered again. It now also
searches every local and remote-tracking ref, which covers open pull requests as
far as they have been fetched.

Underworld development team with AI support from Claude Code
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant