document that the rebuilding is not trivial