Takeshi KOMIYA

Here is salvaged file: [issue-996-1.patch](https://files.zenhub.io/56e19a9eae7df7e0046c8f46) Uploaded using [**ZenHub.io**](http://www.zenhub.io)

Oh, sorry. I overlooked your PR at all. I completely agree with you. It's difficult to resolve cross-references only on the intersphinx module and common inventory data structure. So the...

Unfortunately, you can't modify other documents via the PostTransform. It can modify only the current processing document (`self.document`). If you'd like to modify the document calling `class_directive_doc` directive, you also...

Unfortunately, the `source-read` event does not support the `include` directive. So it will not be emitted on inclusion. >Note that the dumping docname and source[0] shows that the function actually...

I'm not sure how to realize that. But it would be very nice if we'll do it.

It's a tough question. There are many ways to install a JS library to the Sphinx document. * `app.add_js_file()` API from extensions * `html_js_files` setting in conf.py * Load it...

It's not good to discuss jQuery vs vanilla JS. The author of extensions or themes can freely choose the JavaScript framework by their purpose, tactics, or preferences. Sphinx should not...

I feel the option 3 is too much. I'm still not sure developers, theme authors, and users really want to control the version of the JS framework. Is it enough...

I agree that autodoc should generate `py:class` for NewType objects.

-1: Sphinx expects all documents have their title. It's very difficult to support it. I can accept if somebody implemented it simply. How about using `include` directive instead?