Another advice : first documentation shouldn't be for your users our for your development team, but for the Operations team. This documentation must at least allow them to put your application in safe mode quickly, help them warn your team of expected failures when some service your app depends on is to be shut down, or when storage space is reaching the allowed limit.
