add goals and requirements writedown, fix encoding magic comment