create diagrams for portals
write documentation for portals