add signal & state doc