There is a very good way to document software architectures:

I use BPMN 2.0 with DMN

Look it up, see what you think.