Description

To bring it in-line with the other Crocks we need to add in descriptive documentation for the List crock with examples

Task List

• Add main List.md file to 'docs/src/pages/docs/crocks/' based on the others
• Ensure it has the correct 'weight'
• Locate all references to List and update it to link to the new List documentation. Reference the section

adapt_boost_variant.hpp is a good start, but it isn't enough to understand the concept.

E.g., what is subtype_cast_impl for? How Am I supposed to say that a reference to super-type should be cast to a reference to a sub-type?

Currently the empty of Monoid is specified as a nullary function rather than a plain value. Is there a plausible use case that benefits from empty being a function or requires it to be a function?

At the moment, I'm tempted to specify empty as a plain value in [a use case of monoid](https://github.com/calmm-js/p

Stack

References:

• Stack in C++ STL
• Implementing stacks with Python lists
• std::stack
• stack - C++ Reference