updated specification model for documentation