Post

Hi Plragde,

Thanks a lot for your feedback and ideas. Not all of them but quite a few of your ideas, I was playing around with that as well. Not so long ago, I also came to the idea of splitting the document into more parts, something similar you are suggesting. That has in a way certainly some pros... however...

I see some serious cons with that as well. I do for my profession quite some documentation as well and what I observe for large document-setup systems is that it can be come easily and fast quite non-logically, i.e. one might loose easily an overview of the entire structure. What might seems logic to you and me, perhaps because of our work or because the way we think, doesn't mean that it is easy to understand for others, or even if it would be, the danger is still there that people might be no longer interested in it, i.e. dis-encourage them and that's something I would like to avoid.

I do believe that if I would split it into more documents that it becomes for the majority of the readers even more difficult "to look through it" and to understand it. I take the feedback of Ronin1973 to my heart about 60+ pages is an overkill. Yes, he is most probably right, then by splitting this documents in several parts, I do think that makes things worse rather than better. I might be wrong of course and I am open for discussion if you like. Another important point is and must be that the amount of work should be decreasing or staying the same for me, it shouldn't become even more, this what I am doing now is already close to insane ;-)

Things from your feedback that I will take back and chew on it for a while is a change log, I was already playing with that idea but not so sure if I should do that, that would cause even more pages, and your feedback about the non-chapter number of an appendix. I only have Word as a tool and I hate it but since I have no other better tool available and I don't want to spend too much time in getting to know other tools that might be better, I need to somehow learn to live with the dreadful tool called... Word ;-) Anyway, it's the tool I usually use for my work too, so it's "easy" to stay with the same documentation tool. Once I am in a good mood (towards Word) then I will check out that chapter number regarding the appendix :-)

Thank you very much for your open feedback and kind regards, Garfield.