Update changelog (#348)

Author: Veetaha

website/src/changelog.md

@@ -7,12 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [3.8.0](https://github.com/elastio/bon/compare/v3.7.2...v3.8.0) - 2025-10-04
 
-### Other
+### Lint Update Notice
+
+This release brings some rustdoc improvements and no other visible API changes except that `rustc` and `clippy` will start reporting some more true-positive lints. For example builder methods defined via an impl block annotated with `#[bon]` will now be correctly reported as unused if they are not used. Also, using a private type in a public builder method will trigger a `private_interfaces` lint now.
+
+This is all thanks to the updated span handling design researched and implemented by [@Eisverygoodletter](https://github.com/Eisverygoodletter). It's not clear what other new lints the new span handling may trigger in other realworld codebases. If you see a lint from the code generated by `bon` that you think shouldn't be there, please, open an issue, and it'll be fixed as soon as possible!
+
+### Changed
+
+- Make rustdoc source links for the starting function reference original function ([#341](https://github.com/elastio/bon/pull/341)). Thanks [@Eisverygoodletter](https://github.com/Eisverygoodletter) for the contribution!
+- Make rustdoc source links for setters/getters reference original member ([#345](https://github.com/elastio/bon/pull/345))
+
+### Internal
 
-- Add some more assertions to eliminate dead code lints in tests ([#343](https://github.com/elastio/bon/pull/343))
-- Preserve `fn` and `{}` for `start_fn` so that rustdoc generates correct links ([#341](https://github.com/elastio/bon/pull/341))
-- Make rustdoc source links for setters/getters/other_items reference original member ([#345](https://github.com/elastio/bon/pull/345))
-- Fix msrv and unstable CI jobs ([#342](https://github.com/elastio/bon/pull/342))
+- Regular maintenance ([#342](https://github.com/elastio/bon/pull/342), [#343](https://github.com/elastio/bon/pull/343), [#347](https://github.com/elastio/bon/pull/347))
 
 ## [3.7.2](https://github.com/elastio/bon/compare/v3.7.1...v3.7.2) - 2025-09-02