# Feature request: Identifier references in comments and documentation

**URL:** <https://discuss.ocaml.org/t/feature-request-identifier-references-in-comments-and-documentation/17272>\
**Category:** Ecosystem\
**Tags:** ids-in-comment\
**Created:** [September 15, 2025, 4:53pm UTC](https://discuss.ocaml.org/t/feature-request-identifier-references-in-comments-and-documentation/17272 "2025-09-15T16:53:50Z")\
**Posts on this page:** 1\
**Showing post:** 5

<div class="post-metadata">

**Author:** ![dbuenzli](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/dbuenzli/32/18_2.png) [@dbuenzli](https://discuss.ocaml.org/u/dbuenzli)\
**Post date:** [September 16, 2025, 10:31pm UTC](https://discuss.ocaml.org/t/feature-request-identifier-references-in-comments-and-documentation/17272/5 "2025-09-16T22:31:24Z")

</div>

> [@yawaramin](#):
>
> I think they are asking for a stable identifier to be able to use as a reference even across changes in identifier names in the source code.

That’s not exactly what I understood from the OP’s request. I take it more like OCaml’s [refactorization tools](https://discuss.ocaml.org/t/beneficial-ocaml-tools/17149/3) should work in the doc strings too.

Note that if you use the syntax @gasche mentioned you will get a warning about an unknown identifier which is just one step short of what the OP wants.

---

_[View the full topic](https://discuss.ocaml.org/t/feature-request-identifier-references-in-comments-and-documentation/17272)._