The following happens a little bit more often than it should: I look up a function / factor, read the documentation, spend time planning its use, try to use it, and it fails.
Example: NodeRank. It was deprecated quite some time ago, but current documentation states,
“…The function can be used in Buy/Sell and screener rules. However the simulation will run much slower since the ranks must be computed everytime the simulation is run to access the individual components…”
Suggestion: IF XYZ deprecated / altered, THEN c a r e f u l l y update XYZ’s user documentation.
I know you accomplish a great deal with slim overhead, and you turn many of us into loyal fans by doing so.
But, with all due respect, user documentation standards should be higher. It doesn’t cost much time or effort to step up on this point. Just a belief that consistently reliable documentation across the platform is important.
Hi SZ, I think the structure of what is in place now is fine. What would help is a more rigorous approach to timely and precise documentation updates - across the platform (Screener / Ranking / Simulation / Portfolios) - when changes are implemented. Kind regards, D