tag:rubydoc.tenderapp.com,2010-12-26:/discussions/problems/431-cant-display-google-api-ruby-client-gem-docsRubydoc.info: Discussion 2016-09-10T23:06:36Ztag:rubydoc.tenderapp.com,2010-12-26:Comment/387239462015-12-18T22:54:50Z2015-12-18T22:54:51Zcan't display google-api-ruby-client gem docs<div><p>I think rubydoc.info is timing out trying to generate the docs.
I keep getting a 503 error whenever I request generation or when
the hook from github triggers.</p>
<p>Locally generating the docs works with only a handful of
warnings that shouldn't be causing any issues.</p>
<p>➜ google-api-ruby-client git:(master) ✗ yard<br>
[warn]: @param tag has unknown parameter name:<br>
in file <code>lib/google/apis/core/http_command.rb' near line 189
[warn]: Unknown tag @OutputOnly in
file</code>generated/google/apis/appengine_v1beta4/classes.rb<code>near
line 1370 [warn]: Unknown tag @OutputOnly in
file</code>generated/google/apis/appengine_v1beta4/classes.rb` near
line 1370 Files: 295<br>
Modules: 96 ( 2 undocumented)<br>
Classes: 3066 ( 954 undocumented)<br>
Constants: 498 ( 214 undocumented)<br>
Methods: 36391 ( 37 undocumented)<br>
96.99% documented</p>
<p>If there's a timeout or something in place, any way to raise it
for particular projects?</p></div>Stevetag:rubydoc.tenderapp.com,2010-12-26:Comment/387239462015-12-18T23:04:23Z2015-12-18T23:04:23Zcan't display google-api-ruby-client gem docs<div><p>There's no timeout, but I refreshed it on the server and it
seems to be working now. Let us know if this happens again!</p></div>lsegaltag:rubydoc.tenderapp.com,2010-12-26:Comment/387239462015-12-20T13:44:02Z2015-12-20T13:44:04Zcan't display google-api-ruby-client gem docs<div><blockquote>
<p>Steave Isegal</p>
</blockquote>
<p>thx!<br>
How can I confirm that it had been seen temporarily, also I have
become error.<br>
rubydoc.info is Google is the official document. If, as this
situation continues, I think you want the error.</p></div>shintag:rubydoc.tenderapp.com,2010-12-26:Comment/387239462015-12-20T23:09:14Z2015-12-20T23:09:14Zcan't display google-api-ruby-client gem docs<div><p>It seems to work, it just takes an extremely long time to parse,
and given the duration, it's possible that multiple people, or
commit hook calls, could be queueing up refreshes during that time
which just creates a mess.</p>
<p>Typically we would recommend library authors point to docs for
their gem release, not to the GitHub portion of the site, since
GitHub can be refreshed constantly, and for big projects this can
cause problems.</p>
<p>Either that, or they should consider limiting the amount of data
they are throwing at YARD. This relatively small library takes
orders of magnitude longer to parse than even all of Rails, which
says something about how much code is involved here.</p></div>lsegal