Skip to content

Rework /approaches/ around an approach map, add ArTEMiS and a tools page - #7

Open
dfuchss wants to merge 26 commits into
mainfrom
feature/approaches-overview
Open

dfuchss wants to merge 26 commits into
mainfrom
feature/approaches-overview

Conversation

@dfuchss

@dfuchss dfuchss commented Oct 8, 2026

Copy link
Copy Markdown
Member

Summary

What changes for readers:

  • /approaches/ is redesigned. It opens with a map of the four artifact kinds (requirements, architecture documentation, architecture model, code) and the approaches that link them, each label a link. Below it, approaches are grouped (traceability link recovery, consistency analysis, tools) as cards with a thumbnail, artifact tags and venue badges, followed by a strip of published datasets (Benchmark and EVerest).
  • Home page shows the same map in place of the plain approach grid, with a link to the full /approaches/ page.
  • New ArTEMiS page, the TAAS journal extension of ExArch; ExArch points to it, and both list the journal paper under related publications.
  • ARDoCo-TV becomes the tools page (REST API, TraceView, TraceViz) with screenshots and the ASE 2026 landscape figure.
  • Approach pages get artifact tags under the lede, optional gallery figures (LiSSA gets its AIRE 2025 figure) and journal papers in the related list. ArCoTL gets its own figure.
  • Content corrected against the papers for ArCoTL, ArDoCode, ExArch, the inconsistency analysis, LiSSA (incl. REFSQ and AIRE follow-ups), SWATTR and TransArC: pipeline descriptions, F1 numbers and which baseline they refer to.
  • References and badges: TAAS, REFSQ and AIRE venue badges; the SE venue link points to fb-swt.gi.de.
  • /conferences/ is folded into /publications/, which already links every /c/ page; the nav, sitemap and copy lose the section.
  • Link fixes: repositories renamed or merged into ardoco/ardoco and ardoco/lissa, three replication packages with new names, traceview-v2.
  • draw.io SVGs (ECSA 2021 SWATTR, ICSE 2024 ArDoCode) are pinned to a light colour scheme so they no longer draw black boxes on the white plate.

Internally: approaches get a required group and artifacts, a publications list, a gallery and an optional figure.thumb; there is a new datasets collection (nine collections now); the README documents all of it. The series is 17 commits, each self-consistent.

Notes

  • Published URLs are kept alive as redirect stubs: /approaches/tv/ -> /approaches/tools/ and /conferences/ -> /publications/. scripts/audit-features.mjs and the README cover both.
  • /_pages/conferences/ (the accidental Jekyll address) is not served by anything in the repo; Astro skips underscore paths, so keeping it alive would need a host-level redirect.
  • Published files under public/assets/ keep their names (icsa25-transarc.svg depicts ExArch but stays as is); the asset baseline only gains the new figures and the hashes of the two pinned SVGs.
  • The build was not run while authoring; please run npm run build and npm run verify locally. npx astro check reports 0 errors (only the known unused-import hints in the redirect stubs).

Test plan

  • npm run build
  • npm run verify
  • /approaches/ on desktop: map, group sections, thumbnails, datasets strip
  • /approaches/ on mobile: the map collapses to the row list, cards stack
  • /approaches/tools/ and /approaches/artemis/: figures, screenshots, related publications
  • /approaches/exarch/ and /approaches/lissa/: journal paper listed, gallery figure and caption
  • Home page: map and the "All approaches, tools and datasets" link
  • /publications/ and a /c/ page: nav highlight, breadcrumb
  • Redirects: /approaches/tv/, /conferences/, the five legacy /c/ stubs

🤖 Generated with Claude Code

dfuchss and others added 17 commits October 8, 2026 17:02
The approach pages pointed at repositories that were renamed or merged into
ardoco/ardoco and ardoco/lissa, three replication packages carry a new name,
and the SE venue moved to fb-swt.gi.de.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The ECSA 2021 and ICSE 2024 exports carry color-scheme: light dark, so on the
dark site they drew black boxes onto the white plate. Pin them to light and put
both on the plate; the alt text of the ArDoCode figure said ArCoTL.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Three papers had no abbr, so they rendered without a badge. Colours are chosen
apart from the existing venues and readable on the dark background.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/publications/ already links every /c/ page, and "conferences" was a misnomer
for a list that includes journal papers. The URL stays as a redirect stub; the
nav, sitemap and copy lose the section, and its violet accent now belongs to
the home page's publication section only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Approaches get a required group (tlr, consistency, tools) and the pairs of
artifact they link. importance now only orders within a group, so the pages
sort through ordered() instead of a bare importance sort. tv.md gets its group
here and is replaced by the tools page later in the series.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
relatedPublications() merges the conference pages that name an approach with
the BibTeX keys in its own publications field, for papers that only exist as a
redirect stub (the TAAS extension of ExArch). The card badges come from
relatedVenues(), one per venue.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A gallery list in front matter shows extra images after the page text, with an
optional caption (Markdown images cannot carry width and height, which the
audit requires). The light plate colour becomes a token. LiSSA gets its AIRE
2025 figure.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ArCoTL showed the TransArC diagram. The new figure is the heuristic
computation graph from the ICSE 2024 paper.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ArTEMiS recognises architecture entities with an LLM for documentation to model
links. ExArch points to it as its journal extension; the paper reaches both
pages through their publications field.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The page described one viewer; it now covers the REST API, TraceView and
TraceViz with their screenshots and the ASE 2026 landscape figure, and the
conference page links it. /approaches/tv/ stays as a redirect stub.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Wording, numbers and pipeline descriptions of seven approach pages corrected
against the papers: ArCoTL's computation graph, ExArch's feature extraction and
GPT-4o, the extended SWATTR behind the inconsistency analysis, LiSSA's results
and its REFSQ and AIRE follow-ups, the F1 baselines, and the TransArC
replication package link that belonged to ExArch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Benchmark, EVerest and the other published datasets get a yml of their
own with a schema; each links out and to the paper that introduces it. The
page that shows them follows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An inline SVG of the four artifact kinds and the approaches that connect them,
each label a real link, with a row list below 48rem. Node names are words in
approaches.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The page shows the map, then one section per group with cards (thumbnail,
artifact tags, venue badges, code link), then the datasets strip. A figure can
name a thumb that reads better at card size than its diagram.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The home page's approach grid gave way to the same map, with a link to the
full /approaches/ page for the tools and datasets the map leaves out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Front matter of an approach (group, artifacts, figure, thumb, gallery,
publications) and where to add one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Seven of nine cards pointed at the same ardoco/ardoco monorepo, so the
chip did not tell them apart. Each approach page lists its repositories.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@dfuchss
dfuchss requested a balanced review from Copilot October 8, 2026 15:10
@netlify

netlify Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for ardoco ready!

Name Link
🔨 Latest commit 51a4738
🔍 Latest deploy log https://app.netlify.com/projects/ardoco/deploys/6ac8110fe2767f000758d985
😎 Deploy Preview https://deploy-preview-7--ardoco.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

The local node_modules had an older prettier-plugin-astro than the
lockfile, so these three files were formatted by hand and CI's
`prettier --check` disagreed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The approach map omits two declared LiSSA relationships despite being presented as a complete connectivity map.

1 open finding
What changed in this PR

Reworks the approaches experience around an artifact map, adds ArTEMiS, datasets, galleries, and tools content, and consolidates conference navigation into publications.

Changes:

  • Introduces the reusable approach map, grouped cards, artifact tags, datasets, and publication relationships.
  • Adds ArTEMiS and expands ARDoCo tools and research content.
  • Preserves retired URLs through redirects and updates navigation, assets, links, and documentation.
File Description
verification/​asset-sha256.txt Updates asset checksums.
src/​styles/​tokens.css Adds plate and section tokens.
src/​pages/​sitemap.xml.ts Removes the redirected conference index.
src/​pages/​index.astro Replaces the approach grid with the map.
src/​pages/​conferences/​index.astro Redirects to publications.
src/​pages/​c/​[slug].astro Uses publications navigation.
src/​pages/​approaches/​tv/​index.astro Adds the tools redirect.
src/​pages/​approaches/​index.astro Adds grouped cards and datasets.
src/​pages/​approaches/​[slug]/​index.astro Adds artifacts, galleries, and publications.
src/​lib/​redirect.ts Documents additional redirects.
src/​lib/​publications.ts Adds publication-link helpers.
src/​lib/​conferences.ts Updates ordering documentation.
src/​lib/​approaches.ts Adds ordering and publication relationships.
src/​data/​venues.yml Adds and updates venue badges.
src/​data/​papers.bib Assigns new venue abbreviations.
src/​data/​datasets.yml Defines published datasets.
src/​content/​pages/​site/​publication.md Removes obsolete conference-list text.
src/​content/​pages/​site/​nav.md Removes conference navigation.
src/​content/​pages/​publications.md Clarifies paper-page wording.
src/​content/​pages/​home.md Adds the full-approaches link label.
src/​content/​pages/​conferences.md Removes the retired page content.
src/​content/​pages/​approaches.md Defines map and section copy.
src/​content/​pages/​404.md Removes the conference link.
src/​content/​conferences/​refsq25.md Updates the replication repository.
src/​content/​conferences/​icse25.md Updates the replication repository.
src/​content/​conferences/​icsa25.md Updates the replication repository.
src/​content/​conferences/​ecsa21.md Enables the figure plate.
src/​content/​conferences/​ase26-tools.md Links tools and adds its figure.
src/​content/​approaches/​tv.md Removes the superseded approach.
src/​content/​approaches/​transarc.md Adds metadata and corrected content.
src/​content/​approaches/​tools.md Adds the tools approach page.
src/​content/​approaches/​swattr.md Adds metadata and corrected content.
src/​content/​approaches/​lissa.md Expands scope, gallery, and findings.
src/​content/​approaches/​inconsistency-detection.md Corrects pipeline details and results.
src/​content/​approaches/​exarch.md Adds metadata and journal extension.
src/​content/​approaches/​artemis.md Adds the ArTEMiS approach.
src/​content/​approaches/​ardocode.md Corrects metadata, figure, and results.
src/​content/​approaches/​arcotl.md Adds its dedicated figure and details.
src/​content.config.ts Extends schemas and adds datasets.
src/​consts.ts Defines artifacts and approach groups.
src/​components/​pub/​VenueBadge.astro Reuses the shared venue type.
src/​components/​Nav.astro Removes conference styling.
src/​components/​Figure.astro Adds captions and plate tokens.
src/​components/​Artifacts.astro Renders artifact-pair tags.
src/​components/​ApproachMap.astro Implements responsive approach maps.
scripts/​audit-features.mjs Audits the new redirects.
README.md Documents the revised content model.
public/​assets/​img/​approaches/​ase26-landscape.svg Adds the tools landscape.
public/​assets/​img/​approaches/​ase26-traceview.png Adds the TraceView screenshot.
public/​assets/​img/​approaches/​ase26-traceviz.png Adds the TraceViz screenshot.
public/​assets/​img/​approaches/​icse24-arcotl.svg Adds the ArCoTL figure.
public/​assets/​img/​approaches/​taas26-artemis.svg Adds the ArTEMiS figure.
public/​assets/​img/​approaches/​icse24-ardocode.svg Pins light rendering.
public/​assets/​img/​approaches/​ecsa21-swattr.svg Pins light rendering.

🧠 Review effort: Balanced


Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.

Comment thread src/components/ApproachMap.astro

This branch has not been deployed

No deployments
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.

2 participants