Greetings, I hope I chose the best topic for this question.
I'm curious what tools do you use to generate the NatSpec documentation and curious on what some of those keywords mean.
Looking at ERC1155.sol
:
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
Could you please explain how this @dev
commentary is formed?
Not clear to me what's ROOT:erc1155.adoc etc. I would like to pick it up too if it makes docs clearer!
Thanks!