John,
Can you elaborate on a few points to assist in improving the docs?
Specifically --
1. Which document(s) are you referring to?
2. Which exact set of tools are you using? I see you mention Linux several times -- does this mean uClinux from our partner Microtronix? (Sorry if I am getting things confused -- soon our tools will all support running on Linux, as in developing on one's PC running Linux, and that adds the need to be more specific for us).
3. By IDE support do you mean the "Nios II IDE" (where you compile/debug) or IDE interface, as in compact flash/hard drive support? I am guessing from your last question you're trying to get an IDE interface working with uClinux, but I just want to be sure.
Please realize that there is a line to be drawn where our Altera-specific tools (which I agree must be well-documented if we are to succeed) overlap onto other tools used by the industry. For example 'make' - there are entire books (and websites) written on 'make' and providing examples. If you'd like I'd be happy to locate some websites and/or literature references and post them here.
If there are specific areas of our docs that you find lacking please post the title and page# s and we'll take an honest look.
As far as Microblaze -- if you have better luck with it then I suggest you use the product that makes most sense in terms of economics, robustness, and ease of use. Its been our experience that we outperform our competitors (in the admittedly fledgling FPGA-based-processor league) in terms of quality substantially, but if your experience differs we sincerely appreciate feedback telling us where we can improve ourselves.
Please note that I work for Altera so if your problems are on the uClinux side I can't help too much, but I can alert the relevant people of your problems; they frequent this forum too and assist on the linux-related forums.. on the other hand if your issues are with Altera docs I can have those issues looked at here.