document class `pltr::cards::StandardCardsDeck<>`

[schmouk]

Done.

• Fixed some typos in cards_deck_doc.md;
• Enhanced the template definition of cards::StandardCardsDeck<>;
• Enhanced one comment and fixed one bug in cards::CardsDeck<> code;
• Augmented tests of cards::StandardCardsDeck<>.

[schmouk]

Modfiied according to last refactoring of template arguments.

[schmouk]

Fixed a few typos in headers.