Okay… I have had a day or two to read your example and digest it a bit. Now, I am “not-an-accountant” and “not-investor-savy” but I am pretty god at judging documentation.
The documentation itself is laid out nicely and it does read quite easily. My concern is the “Discussion” part. From my read thru everything, the “discussion” function appears to be mainly about the accuracy of the leading document, but the corrections in the discussion do not appear to be moved to the actual documentation portion of the structure even after lengthy periods of time.
This “time lag” makes me think the discussion portion may just be a lazy mans way of adding confusion to the document project. By having all of the corrective comments right there, those responsible for keeping the actual document updated get a free pass to ignore the effort because a reader could just keep reading into the comments to get the corrections.
To me, this makes what should be a concise set of documents into a never ending and ever expanding nightmare. A user would have to read 4 to 5 times the number of pages and then sort out the good advice from the bad on their own.
After doing my best to find positives in this example, all I came away with was frustration.
But let’s NOT throw away the whole idea…
Another version of this where the comments related to a particular chapter (for corrections and additions) could be “Linked” to the chapter might be better. Each chapter would need to have it’s own category in the “Documentation Forum” so as to keep it easier to manage, but then the individual corrective topics could be easily searched and tagged (similar to github) when corrections are added back into the primary online documents. Something like that might work better.
The example model that I forced myself to try out for you, just seems quite the mess. There would need to be a better approach. My suggestion is probably only one of many possible fixes, but I would bet that my observation and analysis of the example is pretty close to what others might have to say about it.
@Not_a_countant … Than you so much for keeping the conversation alive.