[designs] start documenting the designs