docs repercussions from #19