docs(spec): document directive syntax in language grammar (#11022)

docs(spec): document directive syntax in language grammar (#11022) #28882