lint cleanup; document possible channel API