lang: Add example section in `declare_program!` documentation and fix typos

[acheroncrypto]

Problem

declare_program! macro does not have an example associated with it in source code documentation.

Also, adding a source code example would be very verbose due to the necessity of creating two programs.

Summary of changes

• Add an example section and link to our tests
• Fix typos

[vercel[bot]]

@acheroncrypto is attempting to deploy a commit to the coral-xyz Team on Vercel.

A member of the Team first needs to authorize it.