Parameter and return value descriptions missing
I just noticed @param information is not shown. Neither the type, nor the description is shown. Also, the return value description is missing (only its type is shown). Seems like this is actually a bug with the template used, and not just cosmetics, as these are a pretty integral part of an API.
Comments are currently closed for this discussion. You can start a new one.
Keyboard shortcuts
Generic
? | Show this help |
---|---|
ESC | Blurs the current field |
Comment Form
r | Focus the comment reply box |
---|---|
^ + ↩ | Submit the comment |
You can use Command ⌘
instead of Control ^
on Mac
Support Staff 1 Posted by lsegal on 29 Jan, 2016 12:41 AM
Can you provide more information as to where you are not seeing the tags? A URL would be helpful.
2 Posted by Patrik Wenger on 30 Jan, 2016 01:31 PM
Okay, it seems like this only happens on the generated API documentation for released gems (not directly from github).
Here's an example: What I expect is [1]. What I see is [2]. As you can see, in 2, the bullet lists for parameters and return value are missing.
Thanks.
[1] http://www.rubydoc.info/github/paddor/cztop/CZTop/Message#routing_i... [2] http://www.rubydoc.info/gems/cztop/CZTop/Message#receive_from-class...
3 Posted by Patrik Wenger on 31 Jan, 2016 12:14 PM
Sorry, wrong link! [2] is actually http://www.rubydoc.info/gems/cztop/CZTop/Message#routing_id%3D-inst...
4 Posted by Henrique Becker on 06 Jul, 2016 02:54 PM
Hi,
I think I'm having the same problem. I published a gem on rubygems.org (https://rubygems.org/gems/batch_experiment/versions/2.1.2), and it had its documentation generated (http://www.rubydoc.info/gems/batch_experiment/2.1.2).
If I go to the method BatchExperiment::batch (http://www.rubydoc.info/gems/batch_experiment/2.1.2/BatchExperiment#batch-class_method), I don't see the parameters and the return; but as can be seen there (https://github.com/henriquebecker91/masters/blob/d7b5c33ce927e7628fb0a1c7ff3b4d14cca04c29/codes/rb/batch_experiment/lib/batch_experiment.rb#L119) there exists documentation for the parameters and return.
When I execute Yard locally the parameters and return are generated without any warning/error (see annexed screenshot). The output of "yard - v" on my local machine is "yard 0.8.7.6".
I'm doing something wrong? There's any extra evidence I can obtain for you?
Greetings,
Henrique Becker
Support Staff 5 Posted by lsegal on 06 Jul, 2016 10:14 PM
Henrique, seems like this was a temporal issue that got cached. There's more details on this mysterious bug in https://github.com/docmeta/rubydoc.info/issues/82 but we've never narrowed down the root cause since I cannot reliably reproduce it. It works now, though. Let us know if this happens again!
lsegal closed this discussion on 06 Jul, 2016 10:14 PM.