joelniklaus HF Staff commited on
Commit
bb0d7f1
·
1 Parent(s): fe33625

adapt agents.md file to cite papers every time they are referenced.

Browse files
Files changed (1) hide show
  1. AGENTS.md +3 -2
AGENTS.md CHANGED
@@ -102,8 +102,9 @@ The bibliography file is organized into these sections (in order). Always place
102
 
103
  ### Citation Placement Rules
104
 
105
- - **Cite on first occurrence only**: Place `[@key]` the first time a paper/model/dataset/tool appears in the blog post
106
- - **Blog chapter order matters**: The rendering order is defined in `app/src/content/article.mdx` (Introduction Infrastructure Setup Experiments Conclusions Appendix). "First occurrence" means first across the entire concatenated blog, not first within a single chapter file
 
107
  - **Everything citable gets cited**: Models, datasets, benchmarks, architectural techniques, optimizers, inference engines, training schedules, and tools all need citations if they have a paper or official reference
108
  - **Hyperlinks are not citations**: Even if something is already linked (e.g., `[DataTrove](https://github.com/...)`) it still needs a `[@key]` citation
109
  - **Use `@software` for code-only references**: Libraries/tools without a paper get a `@software{...}` entry pointing to the repo or blog post
 
102
 
103
  ### Citation Placement Rules
104
 
105
+ - **Papers: cite every occurrence**: Place `[@key]` or `@key` every time a paper is referenced in the blog post. Papers are research contributions that readers may want to look up at any point, so always provide the citation.
106
+ - **Models, datasets, tools: cite on first occurrence only**: Place `[@key]` the first time a model, dataset, benchmark, tool, or other non-paper reference appears in the blog post. Subsequent mentions don't need the citation.
107
+ - **Blog chapter order matters**: The rendering order is defined in `app/src/content/article.mdx` (Introduction → Infrastructure → Setup → Experiments → Conclusions → Appendix). "First occurrence" means first across the entire concatenated blog, not first within a single chapter file.
108
  - **Everything citable gets cited**: Models, datasets, benchmarks, architectural techniques, optimizers, inference engines, training schedules, and tools all need citations if they have a paper or official reference
109
  - **Hyperlinks are not citations**: Even if something is already linked (e.g., `[DataTrove](https://github.com/...)`) it still needs a `[@key]` citation
110
  - **Use `@software` for code-only references**: Libraries/tools without a paper get a `@software{...}` entry pointing to the repo or blog post