Added more code doc for <facing> and unit tests. Re #6537

Work I did last week but related to quality improve of code and doc