Specify caveats of book-project bibliographies

docs/authoring/footnotes-and-citations.qmd

@@ -81,7 +81,7 @@ You can find CSL files or learn more about using styles at the [CSL Project](htt
 
 ### Bibliography Generation
 
-By default, Pandoc will automatically generate a list of works cited and place it in the document if the style calls for it. It will be placed in a div with the id `refs` if one exists:
+By default, Pandoc will automatically generate a list of works cited if the style calls for it. If it exists, the bibliography will be explicitly placed where a div with the id `refs` is specified:
 
 ``` markdown
 ### References
@@ -90,7 +90,7 @@ By default, Pandoc will automatically generate a list of works cited and place i
 :::
 ```
 
-If no such div is found, the works cited list will be placed at the end of the document. 
+If no such div is found, the works cited list will be placed at the end of the document. Book projects that desire a bibliography of the entire project on a single page should explicitly place the `div`.
 
 If your bibliography is being generated using BibLaTeX or natbib (@sec-biblatex), the bibliography will always appear at the end of the document and the `#refs` div will be ignored.
 

docs/books/book-structure.qmd

@@ -66,7 +66,11 @@ Note that `toc-depth` is independent of `number-depth` (i.e. you can have unnumb
 
 ## References
 
-You should include a `div` with the id `#refs` at the location in your book where you'd like the bibliography to be generated. For example the `references.qmd` file generated by `quarto create project book` includes this:
+By default, the references of any citations in a page will be rendered at the bottom of each file.
+
+If you want the entire bibliography in a single location such as on a dedicated 'references' file., you should include a `div` with the id `#refs` at the location in your book where you'd like the bibliography to be generated.
+
+For example the `references.qmd` file generated by `quarto create project book` includes this:
 
 ``` markdown
 # References {.unnumbered}
@@ -75,6 +79,10 @@ You should include a `div` with the id `#refs` at the location in your book wher
 :::
 ```
 
+Here, the bibliography of all cited works in the project will be placed. 
+
+Note that if you have specified a `.qmd` file-specific bibliography references in the file's header (with `bibliography:`), the references in this file will still be displayed in where the `div` is specified, irregardless of the the location the `bibliography:` was specified.
+
 Note that you can change the chapter title to whatever you like, remove `.unnumbered` to have it be numbered like other chapters, and add other content before or after the bibliography as necessary.
 
 ## Creating an Index