Skip to content

feat: CitationSystem pages should list works instead of references #55

Description

@maehr

Motivation

CitationSystem pages currently list every individual reference that uses the citation system.

For example, the analects-book-chapter page contains a long list of references such as individual book-and-chapter locations from the Analects.

This is misleading because a citation system is associated with one or more works, while references are individual locations expressed using that system. Listing all references also makes these pages unnecessarily long and obscures the more useful relationship between citation systems and works.

Proposed change

Replace the “References using this system” section with a “Works using this system” section.

The list should contain each associated work only once, with a link to its Work page. Individual references can remain accessible from Work pages and the existing reference routes.

Alternatives considered

Keep the reference list

This preserves the current behavior, but produces very long pages and emphasizes individual locations rather than the more useful relationship between citation systems and works.

Show both works and references

This would expose both relationships, but the reference list would still add substantial noise and duplicate information available elsewhere.

Collapse or paginate the reference list

This would improve page length and performance, but would not address the underlying information-model issue. CitationSystem pages should primarily show which works use the system, rather than every reference expressed with it.

Acceptance criteria

  • CitationSystem pages display a “Works using this system” section.
  • Each associated work appears only once.
  • Every listed work links to its Work page.
  • Individual canonical references are no longer listed on CitationSystem pages.
  • Citation systems used by multiple works show all associated works.
  • Citation systems with no associated works display an appropriate empty state.
  • Existing Work and reference pages continue to provide access to individual references.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    addressed-in-v0.1.0Addressed in the v0.1.0 release (PR #4)enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions