Project

General

Profile

Actions

Misc #20639

closed

Request to host C API docs on docs.ruby-lang.org

Added by alanwu (Alan Wu) 4 months ago. Updated 3 months ago.


Description

Having a first-party documentation site benefits readers and helps
contributors improve the contents. The Ruby standard library API benefits from
being hosted on https://docs.ruby-lang.org and it would be nice if the C API
documentation produced by Doxygen can be hosted on the same site as well.

I'm not familiar with the logistics of hosting the documentation site, and traffic
is not free. But I think this is worth considering for the benefit of Ruby
extension authors and maintainers.

At the moment, https://github.com/ruby/actions generates the documentation with
Doxygen but it's not hosted anywhere as far as I can tell. Searching for
"Ruby C API documentation" on Google lead to guides about the API and no results
that provide a comprehensive up-to-date reference.

Updated by znz (Kazuhiro NISHIYAMA) 4 months ago

They hosted on S3 directly (URLs can be deduced from the workflow file), but they are not for public now.

I agree to serve them on docs.ruby-lang.org.

We want to consider their URL before serving.

Current paths are:

  • /en/VERSION/ for rdoc
  • /ja/VERSION/ for rurema
  • /ja/search/ for rurema-search

What path is good for documents generated by Doxygen?

Updated by alanwu (Alan Wu) 4 months ago

I think /capi/en/VERSION is a good starting point.

Updated by hsbt (Hiroshi SHIBATA) 4 months ago

  • Status changed from Open to Assigned
  • Assignee set to znz (Kazuhiro NISHIYAMA)

I'm +1 for this request.

@znz (Kazuhiro NISHIYAMA) Please let me know if you need to my support.

Updated by alanwu (Alan Wu) 3 months ago

  • Status changed from Assigned to Closed

Thanks very much!
We can now work on making the docs even better over time.

Actions

Also available in: Atom PDF

Like0
Like0Like0Like0Like0Like0