Merge pull request #2512 from stewartsmith/stable-rules

doc: stable tree rules