For BF 3.9, I started working on a new document that focuses on "posting" issues. I finished the first draft, but then decided I'd gone in a wrong direction. The new material was OK, but in the wrong place. So, I stepped back, reexamined the BF docs as a whole, and took a new approach. Previously, there were two documents, a User's Guide and a Tutorial, both of which included quite a bit of technical material that wasn't really appropriate, but I needed somewhere to put it. Now there are three documents:
- User's Guide - kept to only user interface issues -- windows, controls, menus, settings, etc for all of BF, including the new blogging and commenting stuff. This reduces the size of this doc and eliminates technical details of no interest to most users.
- Tutorial - kept to "how to" info for all BF, including the new blogging and commenting stuff.
- Technology Guide - a new doc for technical details that most users do not want to see. It now has the following sections:
- Concepts - from the Tutorial.
- System requirements - from the User's Guide.
- Installing BF - from the User's Guide.
- BF Initialization File - from the User's Guide.
- Blogging Initialization File - new section.
- Running BF - from the User's Guide.
- Plugins - from the User's Guide.
Please let me know what you think of this organization -- or anything else about the BF docs.