acl-org / acl-org/acl-anthology

frontmatter overhaul

Open
#8,072 10 comments 0 reactions 0 assignees View on GitHub
db-schema front-end python-library
Dominant language
Python
Stars
797
Forks
408
Avg merge
3d 19h
Merged PRs (30d)
36

Description

Currently frontmatter for volumes, if it has a separate PDF, exists as a special-case paper type. This creates a lot of corner cases when reasoning about the mapping between authors (editors) and papers.

For example, frontmatter items are included on author pages, but not the volumes themselves, which means an editor of a volume without frontmatter PDF will not have it listed on their author page. (#7973)

Also, oddly, bibliographic metadata about the volume is generated for the frontmatter page (if there is one) but not the volume page, which simply links to a bib file for all papers in the volume.

As initially discussed in #8008, it seems like it would make more sense to

- remove frontmatter pages (redirect URLs to the volume page)
- on the volume page, link to the frontmatter PDF (if available) as a separate button
- on the volume page, include volume-level metadata
- on author pages, include volumes

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by tracing the current frontmatter paper-type handling and the generation of volume and author pages described in the issue. Compare how frontmatter PDFs, volume metadata, author listings, and volume links are currently produced. Done means frontmatter URLs redirect to volumes, eligible volume pages expose the PDF and volume metadata, and author pages include the volumes consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
backend, content
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.