# Best Practices for reporting bugs or suggesting improvements to Julia Docs

**URL:** <https://discourse.julialang.org/t/best-practices-for-reporting-bugs-or-suggesting-improvements-to-julia-docs/80157>\
**Category:** General Usage\
**Created:** [April 27, 2022, 5:02pm UTC](https://discourse.julialang.org/t/best-practices-for-reporting-bugs-or-suggesting-improvements-to-julia-docs/80157 "2022-04-27T17:02:46Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![chadagreene](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/chadagreene/32/34924_2.png) [@chadagreene](https://discourse.julialang.org/u/chadagreene)\
**Post date:** [April 27, 2022, 5:02pm UTC](https://discourse.julialang.org/t/best-practices-for-reporting-bugs-or-suggesting-improvements-to-julia-docs/80157/1 "2022-04-27T17:02:46Z")

</div>

What’s the best way to

1. Report possible typos or other technical errors in Julia Documentation, or
2. Discuss potential improvements to the documentation, beyond minor typos?

For example, in the [documentation for the `sin` function](https://docs.julialang.org/en/v1/base/math/#Base.sin-Tuple%7BNumber%7D), I am expecting the **See also** link to `sind` to be clickable, but it’s not. Where should I bring that up? And where should we discuss more substantial issues related to the documentation?

 ![Screen Shot 2022-04-27 at 9.55.43 AM](https://global.discourse-cdn.com/julialang/original/3X/7/6/76812e2509388a944264e7a8e4bd9fecbcb31097.png)

---

<div class="post-metadata">

**Author:** ![jameson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/jameson/32/23_2.png) [@jameson](https://discourse.julialang.org/u/jameson)\
**Post date:** [April 27, 2022, 5:10pm UTC](https://discourse.julialang.org/t/best-practices-for-reporting-bugs-or-suggesting-improvements-to-julia-docs/80157/2 "2022-04-27T17:10:00Z")

</div>

You may notice there is a “source” button on the lower right there, which takes you directly to the line. You can even change this in the github editor right there (though be aware of trailing spaces!). Someone seems to have added the right `[]` block, but seems to be missing the following “`(@ref)`” tag?