Document clean up

@titanous - cleaned up the description and explanation of Flynn’s architecture.
This needs a review by core Flynn team. We would also need a "conventions" list to synthesise standard for names etc across the different docs.