Analysis documents can be useful to see how a project has been designed from a more abstract point of view.
However, would there be any potential downsides on packaging these along with some software on, say, GitHub?
In other words, would there be any valid reason for keeping these separate and hosted on a personal website or on SlideShare?