The NetBeans FeedReader Tutorial
is now available in stereo -- i.e., as an HTML file and
as a PDF file. The coolest thing about this is that they're generated from the same source -- the first time that we've done this for any NetBeans doc. One other doc where we did
do this was the massive J2EE 1.4 Tutorial for NetBeans IDE
, but there we used WebWorks, for which we don't have a license anymore. For FeedReader, all that was used was FrameMaker, together with CSS for styling the HTML file. This has proved, so far (knock on wood), to be an effective and cost-efficient solution (i.e., no expensive WebWorks license needed). There are still quite a few issues to fix, notably the following:
- Need to bundle the CSS with the HTML.
- Junk in HTML thanks to FrameMaker.
- Need to switch the code font back to courier (plus tab problem).
- Need to fix/add/check:
- screenshots (maybe add them during post-processing)
- code (in FrameMaker)
- Need to check result in different browsers.
- Strangeness in the username/password on HTML page because of CSS.
Aside from the above formatting/editorial issues, the main area I need to work on in the tutorial is to work on the explanatory parts. One or two people have indicated that more explanations of why things happen needs to be given. That's something I'll be working on in the coming days. Also, a lot more screenshots need to be added, because currently there's a bit too much text.
In the meantime, if anyone has a few minutes to spare, it would be good if you could check out the tutorial and pass on any issues you find.