more changes based on feedback

README.md

@@ -1,7 +1,6 @@
 # linkedart.js
 
-[Docs](http://linkedartjs.org/) |
-[Contributing](https://github.com/thegetty/linkedart.js/blob/master/.github/CONTRIBUTING.md)
+[Docs](http://linkedartjs.org/) | [Contributing](https://github.com/thegetty/linkedart.js/blob/master/.github/CONTRIBUTING.md) | [NPM](https://www.npmjs.com/package/@thegetty/linkedart.js)
 
 ## What is LinkedArt?
 
@@ -11,8 +10,8 @@ LinkedArt is a Linked Open Data model which is used to describe cultural heritag
 
 This library includes a set of methods for working with [linked.art](https://linked.art) data. Easily manipulate and access rich, complexly nested linked data from any LinkedArt source. This library includes different types of functions or methods:
 
-- _Basic Helpers_: for things like getting the Title, Name, Identifier, or other common properties from a LinkedArt Object. Please see the helpers, or examples in our tests.
-- _Document Navigation and Filters_: to use when building custom functions and queries -- this includes filtering data by multiple classifications, traversing the JSON-LD structure, and working with languages.
+- _Accessors_: Helpers for common use cases like getting the Title, Name, Identifier, or other common properties from a LinkedArt Object. Please see the helpers, or examples in our tests.
+- _Document Navigation and Filters_: For building custom functions and queries -- this includes filtering data by multiple classifications, traversing the JSON-LD structure, and working with languages.
 
 ## Why did we create this?
 
@@ -281,6 +280,15 @@ const result = getClassifiedAs(
 // result should equal: "Young Woman Picking Fruit"
 ```
 
+## List of Files
+
+To better manage the functions into logical groups, this library breaks them into files (described below).
+
+- **Basic Helpers**: Commonly used and shared helpers across the library, mainly for unifying or normalizing the LinkedArt document structure
+- **Language Helpers**: Functions for filtering and managing data in multiple languages
+- **LinkedArt Helpers**: Mainly low-level accessors and filter logic for working with LinkedArt Document Structure, but also includes some higher-level functions such as getPrimaryName (for getting the title).
+- **Object Helpers**: High-level functions for accessing common fields in documents.
+
 ## License
 
 This software is licensed under the [BSD-3](https://opensource.org/licenses/BSD-3-Clause) license.

jsdoc-config.json

@@ -31,7 +31,7 @@
     "destination": "jsdoc",
     "recurse": true,
     "template": "node_modules/better-docs",
-    "readme": "src/docs/jsdoc_home.md"
+    "readme": "./README.md"
   },
   "markdown.hardwrap": true,
   "markdown": {

src/helpers/BasicHelpers.js

@@ -1,7 +1,8 @@
 /**
  * @file BasicHelpers
  * @author Adam Brin, Pamela Lam, Alyx Rossetti, Charles Webb, Selina Zawacki
- * @category Basic
+ * @module BasicHelpers
+ * @category Files
  * @description This file contains helpers for working with LinkedArt JSON-LD data
  */
 
@@ -84,7 +85,7 @@ export function normalizeAatId(id) {
  * @category Basic Helpers
  * @description Some of the fields in LinkedArt may be (but sometimes dont) include parts.
  * For example, `produced_by` which may have a production, or that production may contain multiple
- * parts.  This method returns an array with the single or all parts
+ * parts.  This function returns an array with the single or all parts
  *
  * @param {Object} object - the JSON-LD object (or sub-bart)
  * @param {String} field - the field to look for/in

src/helpers/LanguageHelpers.js

@@ -1,5 +1,6 @@
 /**
  * @file LanguageHelpers
+ * @category Files
  * @author Adam Brin, Pamela Lam, Alyx Rossetti, Charles Webb, Selina Zawacki
  * @module LanguageHelpers
  * @description This file contains helpers for working with Languages in Linked.art

src/helpers/LinkedArtHelpers.js

@@ -2,6 +2,7 @@
  * @file LinkedArtHelpers
  * @author Adam Brin, Pamela Lam, Alyx Rossetti, Charles Webb, Selina Zawacki, Nabil Kashyap
  * @module LinkedArtHelpers
+ * @category Files
  * @description This file contains helpers for working with LinkedArt JSON-LD data
  */
 
@@ -241,6 +242,7 @@ export function getObjectsClassifiedByWithClassification(
 /**
  * Gets the primary name of the JSON-LD object based on an AAT value or other qualifier, uses the AAT value of Preferred Term as the default
  *
+ * @category Accessors
  * @param {Object} submittedResource - the JSON-LD object
  * @param {Object} options - additional options
  * @param {String|Array} options.requestedClassifications - the requested classifications (default is aat.PRIMARY_TERM)
@@ -273,6 +275,7 @@ export function getPrimaryName(
 /**
  * Gets the primary names of the JSON-LD object based on an AAT value or other qualifier, uses the AAT value of Preferred Term as the default
  *
+ * @category Accessors
  * @param {Object} submittedResource - the JSON-LD object
  * @param {Object} options - additional options
  * @param {String|Array} options.requestedClassifications - the requested classifications (default is aat.PRIMARY_TERM)

src/helpers/ObjectHelpers.js

@@ -2,6 +2,7 @@
  * @file LinkedArtHelpers
  * @author Adam Brin, Pamela Lam, Nabil Kashyap
  * @module ObjectHelpers
+ * @category Files
  * @description This file contains convenience helpers for working with LinkedArt objects
  */
 

src/index.js

@@ -1,5 +1,5 @@
 /**
- * This is the main entrypoint for the module. We import the methods we want to expose
+ * This is the main entrypoint for the module. We import the functions we want to expose
  * from the appropriate helper and then export them as part of the module.
  */
 import {