organization of optimization options in manual

[Sandra Loosemore]

On 01/14/2015 08:41 PM, Jeff Law wrote:
> With the section being ~60 pages, my first thought is we have way too
> many options!

Heh, at least we have documentation for all those options.  :-)

> But that's not likely to change.  Though perhaps the
> process will encourage some culling of options that really don't make
> sense anymore.

Would we want to remove useless options outright, or deprecate them for 
a while with removal to happen at some future time, or just deprecate 
them and/or document that they are not useful?

> I think it's really just grown organically and putting more structure
> into it would probably be worth the effort.  The question I have is once
> we've identified the high level buckets, how much stuff are we likely
> going to have in the miscellaneous bucket.  If the misc bucket is still
> big then folks are still going to struggle with finding the information
> they want/need (or think they want/need).

I guess it can't be any worse than it is now, though, where the whole 60 
pages is essentially a "misc bucket".  I'll see if I can put together a 
plan for splitting things up....  if there are too many leftovers maybe 
others can help by suggesting different/additional categories.

-Sandra