Actually, before merging, could you please add these links back, but not in the first paragraph. For instance by adding one line after that first paragraph that explicitly says 'For more discussion, please look at the documentation on :ref:...'