add docs note to address #12078