I wrote a sizeable chunk of documentation for astronomical software with LyX about 15 years ago. The concept is excellent and in general I like it. There were some rough edges - especially with table & image handling, but in general it's pretty neat. I should probably give it another go some day.