docs: Clarify usecase of data files
authordigitalcraftsman <digitalcraftsman@protonmail.com>
Fri, 16 Sep 2016 15:05:38 +0000 (17:05 +0200)
committerdigitalcraftsman <digitalcraftsman@protonmail.com>
Fri, 16 Sep 2016 15:05:38 +0000 (17:05 +0200)
Fixes #1769

docs/content/extras/datafiles.md

index 52c6dafb091e36c73c4ca968a4a07cfc89ebcdc5..4adb68fcb551eeef20fc9506e77c442e42c326fb 100644 (file)
@@ -22,7 +22,9 @@ Data Files can also be used in [themes](/themes/overview/), but note: If the sam
 
 ## The Data Folder
 
-As explained in [Source Organization](/overview/source-directory/), the `data` folder is where you can store additional data for Hugo to use when generating your site. These files must be YAML, JSON or TOML files (using either the `.yml`, `.yaml`, `.json` or `toml` extension) and the data will be accessible as a `map` in `.Site.Data`.
+The `data` folder is where you can store additional data for Hugo to use when generating your site. Data files aren't used to generate standalone pages - rather they're meant supplemental to the content files. This feature can extend the content in case your frontmatter would grow immensely. Or perhaps your want to show a larger dataset in a template (see example below). In both cases it's a good idea to outsource the data in their own file.  
+
+These files must be YAML, JSON or TOML files (using either the `.yml`, `.yaml`, `.json` or `toml` extension) and the data will be accessible as a `map` in `.Site.Data`.
 
 **The keys in this map will be a dot chained set of _path_, _filename_ and _key_ in file (if applicable).**