The difference between your documentation and mature documentation is the presumption you make about what people should already know.
The rule to follow is to write small sections about each aspect of the functionality, but within those small sections be precise and explicit about everything that is referenced in the section.
That is, a person should be able to grasp the precise definition of each term and also find within the section a satisfactory connection for each term that might possibly be a reference to another term.
In general, this would mean about 70% more verbiage in your detailed documentation areas.
But in my case, I believe you are making an implicit synonym of the word 'activated' when describing gems that are 'attached'.
In addition, it is difficult to determine if a gem is 'attached' by looking for clues in the Ruby SDK and Gems dialog.
Although it is possible to see a list of gems in the 'attach gems' dialog, when you select a gem or group of gems and select 'attach', there is no explicit confirmation that any specific gems have thereby become 'attached' to the project.
There could be a column in the Ruby and SDK Gems dialog grid that would identify which gems were attached to the current project.
In any case, the only thing I can presume almost for sure is that when I see a gem listed in the project under the 'libraries' node, I'm guessing it is 'attached'.
However, since you don't explicitly define 'activated' and you seem to use 'activated' as a synonym for 'attached', I am unable to determine if MY PROBLEM with not seeing Cucumber and Rspec generators is because I have not followed your instructions to install, attach, AND ACTIVATE, the cucumber, rspec and rspec-rails gems.
So would you please compose a sentence or two that either uses activated in its different meaning from attached or specifically state that activated means attached and also tell me how I can absolutely verify that my gems are considered activated and attached for the purposes of satisfying the requirements of 'activating' the proper rake tasks and loading the proper generators so that I can see the list of generators which are, at this time, NOT SHOWING in my menus?
I am using RM 2.02, 95.202, with Ruby 1.9.2 and the most current versions of the gems.