It would actually be easier to write a program to compile it [help docs] for us.
Agreed, the last project I worked on tried to maintain help separately from the actual code, and the truth is it never works. I spent so much time rewriting documentation I never had time to code, or the documentation was out of date and wrong, which made things even more confusing to the users, and myself! (I was the 4th person to maintain that project! I had to figure it out from the docs myself) Since the docs where so poor, I couldn't get anyone one else to help me.
The MDF2 gui is already smarter than the old one. It is file/object/entity/creature aware. The old gui would just flip through the raws and 'flip' specific bits, to hackishly turn items on and off. Our new one is allot smarter, however.... Dynamically generated help files won't make it into the first release... we are heading in that direction however...
I've tried pushing the idea of a Wiki or shared online resource for members of this team, but the idea is met unsuccessfully.
We already have one,
http://www.javaforge.com/project/MWDFthere is a wiki there for us to use for anything (no one has touched it) a bug tracker (mostly unused) and a code repository (I stopped pushing updates, due to lack of interest.)
This is something that is requested over and over, but no one ever uses. I know the site is a little clunky, but MDF2 includes DF which is a game we don't own the copyright to. We can't release toady's game as a full open source program, so not all hosting sites will accept us. We don't own the copyright to the 'raws' that make up the bulk of MDF. Also, unless we pay money to QT we MUST release the source to the masterwork gui, which is something I planed on doing anyways. If there are specific deficiencies of the javaforge site that are stopping people from using it they have never been brought up in discussion, therefor I haven't put any effort into setting up something better since what we have isn't being used.
MDF2 isn't in the code repo because there are only two versions, the alpha and the one meph is working on that no one has seen. MDF1 was in the code repo until 1.9.5 was released and it was frozen. Once Meph starts releasing MDF2 updates I'll probably get the repo going again if there is enough demand for it.
Eventually I want to get Meph using a repo directly, and having the app auto-update from the repo so that everyone is always up-to-date, and we don't have to include the raws in the gui download making that file smaller, and it having to be updated/re downloaded less often.
Someone sent me a new bugtracker, but I was going to wait untill meph got up and running again to talk to him about what kind of a bug tracking / help support system he wants to setup and use. Once we decide on something, We could also start to integrate it into the gui. However, so far the consensus has been just to keep using the forum threads. Meph does read it and keeps a list of issues on his own computer.
I hope this contribution helps in some small manner.
Documentation always helps! Thank you!