From 5451dc2f5a09fa06df32d1a1661623b475170566 Mon Sep 17 00:00:00 2001 From: Noah Loomans Date: Tue, 3 Jul 2018 19:33:51 +0200 Subject: client: Document getHistory --- src/client/react/lib/getHistory.js | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'src/client') diff --git a/src/client/react/lib/getHistory.js b/src/client/react/lib/getHistory.js index 5fef902..daa984b 100644 --- a/src/client/react/lib/getHistory.js +++ b/src/client/react/lib/getHistory.js @@ -5,7 +5,20 @@ import { makeUpdateQuery, } from './url'; +/** + * Make a getHistory function. This function is used in index.js when creating + * the redux store. + * @param {history} history + * The history object from the `history` package. + * There may only be a single shared history object in the application, which + * is why it's delivered from `../index.js`. + */ export default function makeGetHistory(history) { + /** + * Get a collection of helpers for common browser history interactions, and a + * collection of precalculated values from the address bar. This function is + * used in actions. + */ return function getHistory() { const user = userFromLocation(history.location); const week = weekFromLocation(history.location); -- cgit v1.1