These are chat archives for ethereum/homestead-guide
Hey @hughlang ... so for the internal references, I think we could really use a decoupling of the display names of the links from the actual link names. They are currently the same (through ignorance on my behalf at least!). We also have warnings popping up every few days about clashing external references too. I've "fixed" some of this with slight variants in the names, but that sucks balls and we need a better solution.
For example ... we have ...
`Solidity <https://solidity.readthedocs.org/en/latest/>` .. seealso:: `Solidity docs <https://solidity.readthedocs.org/en/latest/>`_ has more examples and guidelines to writing Solidty code. .. note:: More information on solc and compiling Solidity contract code can be found `here <https://solidity.readthedocs.org/en/latest/frequently-asked-questions.html#how-do-i-compile-contracts>`_. `Solidity Docs <https://solidity.readthedocs.org/en/latest/>`
In various places. If they all said "Solidity Docs" then that causes warnings. Which is dumb, but must mean we have the syntax right.