Improving documentation for recon_alloc

Adding tips and pointers of what to do to solve problems that can be
found using the functions, following helpful advice from @garazdawi.