documentation.md

Documentation: papers.json Structure (as used in scripts.js)

This document describes the structure and meaning of each key in the data/papers.json file, as expected by the client-side code in scripts.js.

papers.json Format

papers.json is an array of objects. Each object represents a paper or article entry with the following keys:

Key	Type	Required	Description
title	string	Yes	Title of the paper or article.
authors	string[]	Yes	Array of author names.
venue	string	No	Conference, journal, or publication venue.
year	number	No	Year of publication.
section	string	Yes	Main section/category (e.g., "Machine Learning", "Blockchain").
tags	string[]	No	List of tags or topics (e.g., "Transformers", "Sequence Modeling").
link	string	No	URL to the publisher or official paper page.
pdf	string	No	URL to the PDF of the paper.
code	string	No	URL to the code repository (e.g., GitHub).
notes	string	No	URL to additional notes or resources.
abstract	string	No	Abstract or summary of the paper.
reflection	string	No	Personal notes or reflections about the paper.

Example Entry

{
  "title": "Attention Is All You Need",
  "authors": ["Vaswani et al."],
  "venue": "NeurIPS",
  "year": 2017,
  "section": "Machine Learning",
  "tags": ["Transformers", "Sequence Modeling"],
  "link": "https://arxiv.org/abs/1706.03762",
  "pdf": "https://arxiv.org/pdf/1706.03762.pdf",
  "code": "https://github.com/tensorflow/tensor2tensor",
  "notes": "https://example.com/notes",
  "abstract": "Introduced the Transformer architecture.",
  "reflection": "Why transformers beat RNNs for long dependencies; key insight: self-attention scales O(n^2) but parallelizes beautifully."
}

Notes

• title, authors (as an array), and section are required for each entry.
• All other fields are optional and can be omitted if not applicable.
• The script expects authors as an array of strings.
• The script will gracefully handle missing optional fields.