What are some gems with excellent YARD docs, that can be used as a reference?
@katafrakt I would also like to know.

@Kowfm I think mail might be my favourite so far, although it's RDoc, not YARD.

https://www.rubydoc.info/gems/mail

File: README — Documentation for mail (2.8.1)

@katafrakt depends on what you mean by excellent YARD docs. I would recommend:

* command_kit (https://rubydoc.info/gems/command_kit)
* spidr (https://rubydoc.info/gems/spidr)
* Ronin gems (https://ronin-rb.dev/docs/#api)
* most of my gems since I always use YARD and try to get >80% doc coverage.
#YARD #yardoc

File: README — Documentation for command_kit (0.4.0)

@postmodern I don't know exactly what I mean, but I'm looking for gems that use YARD for more than just one-liner three-words description of every method. I want to slowly start testing my YARD template with some real-life examples.

Thanks for these suggestions, they look very useful!

@katafrakt I am curious to see how your YARD template turns out. I've thought about making my own YARD template for a big project that includes a dark-mode switch or custom color scheme, but it seems like a ton of work just to change a few things.
@katafrakt I’d like to think the Mocha docs are a fairly decent use of YARD: https://mocha.jamesmead.org/
File: README — Mocha 2.4.5

@floehopper Yes! These are looking great. Thanks!
@katafrakt they’re incomplete, but we’re trying our best to make devise-passkeys’ a YARD docs shine https://www.rubydoc.info/github/ruby-passkeys/devise-passkeys
File: README — Documentation for ruby-passkeys/devise-passkeys (main)

@katafrakt I humbly submit my own gem, Good job. I worked with a consultant on the docs a few years ago, though they've degraded a bit since then 😓

https://island94.org/2020/10/goodjob-v1-3-web-dashboard-and-full-documentation

GoodJob v1.3: Web dashboard and full documentation

GoodJob version 1.3 is released. GoodJob is a multithreaded, Postgres-based, ActiveJob backend for Ruby on Rails. If you’re new to GoodJob, read the introduc...

@katafrakt I remember putting a lot of effort in some of mine, like https://github.com/molybdenum-99/infoboxer. Not sure about "excellent", but I was happy with the results at the moment of doing it.
GitHub - molybdenum-99/infoboxer: Wikipedia information extraction library

Wikipedia information extraction library. Contribute to molybdenum-99/infoboxer development by creating an account on GitHub.

GitHub