There is documentation, although slightly dated, at tldp:
From Fedora, there is:
On Thu, Oct 25, 2012 at 2:00 PM, Sourav Basu <sourav.tumu(a)yahoo.com> wrote:
Can anyone please tell me how to learn to read spec files? I mean any
documentation regarding it where I can get more info.
fedora-join mailing list