Principle:Mbzuai oryx Awesome LLM Post training Paper Entry Formatting
| Knowledge Sources | |
|---|---|
| Domains | Curation, Documentation |
| Last Updated | 2026-02-08 07:30 GMT |
Overview
A formatting pattern that converts paper metadata into standardized markdown entries with venue badges for inclusion in a curated awesome list.
Description
Paper Entry Formatting defines the visual presentation of each paper in the curated list. Two distinct formats are used depending on the section: a table format for the Survey section (with columns for title, date, and link) and a bullet-list format for all other sections (with inline shields.io badges showing venue and year). The badges use color coding to distinguish arXiv preprints (red) from peer-reviewed publications (blue).
Consistent formatting ensures readability and allows readers to quickly scan papers, assess their provenance (arXiv vs. conference), and access them via direct links.
Usage
Use this principle when formatting paper entries for any curated academic list that:
- Includes papers from both preprint servers and peer-reviewed venues
- Benefits from visual distinction between preprints and published papers
- Needs direct links to papers for one-click access
- Should be readable in standard GitHub markdown rendering
Theoretical Basis
Pseudo-code Logic:
# Abstract formatting pattern (NOT real implementation)
def format_paper_entry(paper, section_type):
if section_type == "survey":
return f"| {paper.title} | {paper.date} | [{paper.link_text}]({paper.url}) |"
else:
badge_color = "red" if paper.venue == "arXiv" else "blue"
badge = f""
return f"* {paper.title} [[Paper]]({paper.url}) {badge}"
Design decisions:
- Color coding: Red for arXiv (preprint), blue for peer-reviewed (NeurIPS, ACL, ICLR)
- Two formats: Tables for structured sections, bullets for browsable lists
- Direct links: Every entry includes a clickable link to the paper