Enhancement

We are now heavily relying on internal design docs. It is not friendly for the community to understand the code base. We should at least have comments for important functions, describing their usages.