improved rest interface and basic concepts adding diagrams