doc: preparing the future