Apache Forrest docs update (bug FOR-1233)

docs update
by
DC
(fixes bug FOR-1233)

:

Improved documentation about configuring project entities file,
and general tips for upgrading.