document post-active switch and behavior#2450

rjayasinghe wants to merge 1 commit intomaincapire/docs:mainfrom

post_active_javacapire/docs:post_active_javaCopy head branch name to clipboard