clarify based on Raniere feedback
fix last commit
switching to kramdown
filling some thoughts for the first iteration