Ya, i agree with your writings, we should differentiate the functional and technical documents. And need to document the system overview,work-flow with diagrams(Its all based on how you want the document either in a overall or in-depth manner)

Santhosh Kumar R.