Update self.caller and self.signer documentation

[craigjson]

Makes the following updates to the .aleo documentation

1. Updates existing references to self.caller to reference self.signer
2. Adds a section for self.caller explaining the new feature
3. Provides examples of the difference between self.signer and self.caller

One question, with this update, there will be inconsistency between the Leo and Aleo documentation. Namely, that because Leo has not yet implemented the new self.caller, the documentation that refers to it https://developer.aleo.org/leo/language#selfcaller will actually be talking about self.signer in Aleo instructions. I worry this may cause some confusion. We could remove this section in the Leo docs for now, curious to your thoughts @collinc97

Part of: https://github.com/AleoHQ/snarkVM/pull/2020

[collinc97]

Thanks for the PR @craigjson

I think the motivating example is a good way to introduce this command.
Do you think developers will copy and paste this example into their projects?
Do you have additional snarkvm CLI commands that you ran to test the functionality?

[collinc97]

Makes the following updates to the .aleo documentation

1. Updates existing references to self.caller to reference self.signer
2. Adds a section for self.caller explaining the new feature
3. Provides examples of the difference between self.signer and self.caller

One question, with this update, there will be inconsistency between the Leo and Aleo documentation. Namely, that because Leo has not yet implemented the new self.caller, the documentation that refers to it https://developer.aleo.org/leo/language#selfcaller will actually be talking about self.signer in Aleo instructions. I worry this may cause some confusion. We could remove this section in the Leo docs for now, curious to your thoughts @collinc97

Part of: AleoHQ/snarkVM#2020

I expect the feature parity between Leo and Aleo Instructions to be resolved this week.
For now you could add an Admonition that makes it clear for people that there is a difference.

[craigjson]

Thanks for the PR @craigjson

I think the motivating example is a good way to introduce this command. Do you think developers will copy and paste this example into their projects? Do you have additional snarkvm CLI commands that you ran to test the functionality?

A developer can copy and paste this example, however I'd say it's fairly academic and limited in it's usability for a production program. It reminds me of an example a professor would use to show how OOP Inheritance works.

I added some steps to create a project and run this on the CLI to generate the output that is provided

[collinc97]

Hi @craigjson can you see my latest PR against this one #291

[craigjson]

Hi @craigjson can you see my latest PR against this one #291

merged

[collinc97]

LGTM