I realize that changes take place and that the version he documented in his video is not the same as what exists now. I went to GitHub to look at the commands like he is talking about but the web page does not look like what is in his video. The biggest problem I have is that the GitHub page the wiki points to is one of the most non-beginner-userfriendly pieces of documentation I have ever seen.
Yes, the documentation has been undergoing a massive revamp. It was hoped that the new version would be friendlier, but it seems that it can still be improved.
In the video, there on the front page at the 3:45 mark is a big "Commands" section. I cannot find that anywhere (after looking literally for 3 hours). At the bottom of the page currently it says ..and I quote
"The full documentation is available online here, from the README.html page in the DFHack distribution, or as raw text in the ./docs folder. If you're an end-user, modder, or interested in contributing to DFHack - go read those docs."
I clicked on the link but I do not see any "ReadMe" link or the word "Distribution" in any link either. I also do not see anything saying /docs in the linked page. However I do see docs folder on the github page which shows an images and styles folders which again confuses the hell out of me as nothing there has anythnig remotely resembling actual documentation of anything.
Two issues here. First, the "Commands" section has been rearranged into the new "User Manual" section in
the online documentation. The "DFHack Core", "DFHack Plugins", and "DFHack Scripts" pages each list their set of the commands. It got a bit too unwieldy as a single page, but the new structure is neither searchable nor intuitive unless you already know the distinction.
Second, the part you quote can be misinterpreted. It intends to list three different places to find the documentation; however, the second only applies to a released distribution, and even then only to releases that include built documentation. The third also applies mostly to releases, but since you looked at the /docs folder on GitHub, you must have seen the list of .rst files, which are the "raw text" documentation described in the quote. If, instead of interpreting the three items as separate, you interpret the second as modifying the first, then yes, you'll have trouble finding README.html after following the link.
Can someone for the love of GOD point me in the right direction? Also.. can someone clean up the github page to be more user friendly and more concise and clear as to where the bloody hell to go to learn about stuff?
I've changed the link on the dwarffortresswiki page to go directly to
the online documentation. Any suggestions on how to be clearer in the GitHub Readme? Would bullet points help?
Part of the issue may be that DFHack isn't meant to be something you just try. It's a tool for accomplishing something in particular. What were you hoping for?