added som explainations and renamings