Sage Gear Advice
by Silversage of Eitrigg

This is BETA software. Comments, bug reports, etc, are welcome. That said, it's
taken me a year to finally publish this, so fixes might be slow. :( Sorry.

Purpose: SGA is a Pawn-like addon that understands reforging. After installing
you should see tooltip lines for armor and weapons that show the relative value
of those items for your character. SGA will compute that value, assuming what
it calculates to be the best possible reforging. For items which SGA believes
should be reforged, it also displays the optimal reforging for that item (for
a particular usage).

Customization: You can customize the stats weights for classes and specs, but
there's currently no UI. To change them, find the file named "stats.lua" and
open it for edit (with a text editor, not MS Word!). That file contains
instructions on how to tweak the weights. After editing and saving, in WoW,
  /console reloadui
should reload your world and pick up the new stats.

--------------------------------------------------------------------------------
     FAQ
--------------------------------------------------------------------------------

[ How is Sage Gear Advice's reforging calculation different from others? ]

First, the calculation is per-item, and is not trying to optimize an entire
kit of existing gear. The global optimization is good, but not as useful when
a piece drops and you're trying to decide whether to spend DKP on it. If you're
hard-core, you should use SGA for quick evaluation of gear, and use a global
optimizer to actually do your reforging. (Honestly, they aren't going to be
that different if they're based on the same stat coefficients.)

Second, Sage Gear Advice does not follow a simple priority order for stats that
can be reforged. Instead, it will pick the reforging that provides the most
improvement in the item based on the stats given. For example, if your stats
have weight Expertise=100, Mastery=20, Haste=1, then for an item that has both
mastery and haste, it might seem better to reforge haste to expertise. But in
fact, if the item has a lot more mastery than haste, you can get a bigger
improvement by reforging mastery to expertise.

[ How does Sage Gear Advice handle gem sockets? ]

Not in the best way, but okay.

If specific stat values aren't provided for various sockets, SGA will guess
the socket value, approximating it as being equivalent to a Cata blue-level
gem of that class/spec's best primary stat.

[ How does Sage Gear Advice handle meta-sockets? ]

Horribly. It doesn't weight them at all. Please be very cautious comparing two
items when only one has a meta-socket.

--------------------------------------------------------------------------------