Jefffrey opened a new pull request, #7020:
URL: https://github.com/apache/arrow-rs/pull/7020

   Markdown can't handle multiple reference links with same name. i.e.
   
   ```markdown
   Check out [this link].
   
   [this link]: https://github.com/apache/arrow-rs
   
   Now how about [this link].
   
   [this link]: https://github.com/apache/datafusion
   ```
   
   The link on `Now how about this link` will point to arrow-rs instead of 
datafusion.
   
   Example of how that's affecting current README:
   
   
![image](https://github.com/user-attachments/assets/6acc9408-4baf-4e35-a894-8fd85b5be843)
   
   For now I've decided to include the issue number as part of the text so the 
reference links have unique names.
   
   Alternatives were either slightly change the text, like making the second 
one:
   
   ```markdown
   See [this issue] for more nuances.
   ```
   
   Which I didn't like as I feel we may fall into this issue again.
   
   Another alternative would be to inline both:
   
   ```markdown
   Check out [this link](https://github.com/apache/arrow-rs).
   
   Now how about [this link](https://github.com/apache/datafusion)
   ```
   
   Don't have a particular preference for that or current approach.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscr...@arrow.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to