Implementation notes
===========================