Feature ks

Add doc comment describing the contract here.