# Where is the webdocs file?

**URL:** <https://forum.ansible.com/t/where-is-the-webdocs-file/26137>\
**Category:** Ansible Developer\
**Created:** [November 27, 2017, 5:13am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137 "2017-11-27T05:13:40Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 27, 2017, 5:13am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/1 "2017-11-27T05:13:40Z")

</div>

Based on [http://python.usyiyi.cn/documents/Ansible/ansible/dev\_guide/developing\_modules\_documenting.html#testing-documentation](http://python.usyiyi.cn/documents/Ansible/ansible/dev_guide/developing_modules_documenting.html#testing-documentation)

But where is the webdocs file?

Thanks  
Jae Kim

---

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 27, 2017, 7:20am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/2 "2017-11-27T07:20:19Z")

</div>

Some replied “There isn’t a file named webdocs, it’s just a make target.”  
Then under which director should the command be run?  
When it is run under below, it says.

[root@localhost network]# pwd  
/usr/lib/python2.7/site-packages/ansible/modules/network  
[root@localhost network]# make webdoc  
make: \*\*\* No rule to make target `webdoc’. Stop.

---

<div class="post-metadata">

**Author:** ![tkuratom](https://avatars.discourse-cdn.com/v4/letter/t/b19c9b/32.png) [@tkuratom](https://forum.ansible.com/u/tkuratom)\
**Post date:** [November 27, 2017, 2:10pm UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/3 "2017-11-27T14:10:29Z")

</div>

It should be run from a checkout of the source repository. The dev\_guide documentation anticipate that you are developing ansible and working from a checkout.

-Toshio

---

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 28, 2017, 2:24am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/4 "2017-11-28T02:24:43Z")

</div>

Hi

It gets stuck at this point

label: ansible\_executable (if the link has no caption the label must precede a section header)  
/root/work/ansible\_git/ansible/docs/docsite/rst/plugins/strategy.rst:37: WARNING: undefined label: strategy (if the link has no caption the label must precede a section header)  
/root/work/ansible\_git/ansible/docs/docsite/rst/plugins/vars.rst:11: WARNING: undefined label: host\_vars (if the link has no caption the label must precede a section header)  
/root/work/ansible\_git/ansible/docs/docsite/rst/plugins/vars.rst:11: WARNING: undefined label: group\_vars (if the link has no caption the label must precede a section header)  
/root/work/ansible\_egit/ansible/docs/docsite/rst/porting\_guide\_2.0.rst:242: WARNING: py:attr reference target not found: self.playbook  
/root/work/ansible\_git/ansible/docs/docsite/rst/porting\_guide\_2.0.rst:242: WARNING: py:attr reference target not found: self.play  
/root/work/ansible\_git/ansible/docs/docsite/rst/porting\_guide\_2.0.rst:242: WARNING: py:attr reference target not found: self.task  
/root/work/ansible\_git/ansible/docs/docsite/rst/porting\_guide\_2.5.rst:46: WARNING: undefined label: fixme (if the link has no caption the label must precede a section header)  
/root/work/ansible\_git/ansible/docs/docsite/rst/python\_3\_support.rst:78: WARNING: unknown option: -e  
/root/work/ansible\_git/ansible/docs/docsite/rst/release\_and\_maintenance.rst:16: WARNING: undefined label: schedule (if the link has no caption the label must precede a section header)  
writing output… [100%] win\_wait\_for\_module … zypper\_repository\_module  
waiting for workers…

---

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 28, 2017, 2:25am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/5 "2017-11-28T02:25:33Z")

</div>

> > Also this error was seen previous to this one

WARNING: intersphinx inventory ‘[https://docs.python.org/2/objects.inv](https://docs.python.org/2/objects.inv)’ not fetch able due to \<class ‘requests.exceptions.SSLError’\>: HTTPSConnectionPool(host=‘do [cs.python.org](http://cs.python.org)’, port=443): Max retries exceeded with url: /2/objects.inv (Caused by SSLError(SSLError(1, ‘[SSL: CERTIFICATE\_VERIFY\_FAILED] certificate verify fa iled (\_ssl.c:600)’),))  
loading intersphinx inventory from …/python2-2.7.13.inv…  
loading intersphinx inventory from [https://docs.python.org/3/objects.inv](https://docs.python.org/3/objects.inv)…  
WARNING: intersphinx inventory ‘[https://docs.python.org/3/objects.inv](https://docs.python.org/3/objects.inv)’ not fetch able due to \<class ‘requests.exceptions.SSLError’\>: HTTPSConnectionPool(host=‘do [cs.python.org](http://cs.python.org)’, port=443): Max retries exceeded with url: /3/objects.inv (Caused by SSLError(SSLError(1, ‘[SSL: CERTIFICATE\_VERIFY\_FAILED] certificate verify fa iled (\_ssl.c:600)’),))  
loading intersphinx inventory from …/python3-3.6.2.inv…  
building [mo]: targets for 0 po files that are out of date  
building [html]: targets for 1732 source files that are out of date  
updating environment: 1732 added, 0 changed, 0 removed  
reading sources… [10%] avi\_analyticsprofile\_module … azure\_rm\_virtualmachine reading sources… [15%] azure\_rm\_virtualmachine\_scaleset\_module … ce\_interfac reading sources… [21%] ce\_ip\_interface\_module … community/reporting\_bugs\_and reading sources… [78%] plugins/inventory/host\_list … proxysql\_scheduler\_modu reading sources… [100%] win\_ping\_module … zypper\_repository\_module

---

<div class="post-metadata">

**Author:** ![tkuratom](https://avatars.discourse-cdn.com/v4/letter/t/b19c9b/32.png) [@tkuratom](https://forum.ansible.com/u/tkuratom)\
**Post date:** [November 28, 2017, 3:06am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/6 "2017-11-28T03:06:58Z")

</div>

This doesn’t seem like it is frozen. How long did you wait for it to finish? Did your CPU continue to be working hard during this time?

There was a Sphinx version that did get stuck when building docs but in general, the docs build does take quite a while. It takes over an hour for me on modern hardware with plenty of ram.

-Toshio

---

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 28, 2017, 8:14am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/7 "2017-11-28T08:14:58Z")

</div>

Hi

Thanks for your help. I waited and the process completed.  
I was wondering if there is a way to have it partially updated with newly added custom or community Ansible module.  
I add new files and executed it. It seems to run the whole process again.

Thanks  
Jae Kim

---

<div class="post-metadata">

**Author:** ![Jae\_Kim](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@Jae\_Kim](https://forum.ansible.com/u/Jae_Kim)\
**Post date:** [November 28, 2017, 8:17am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/8 "2017-11-28T08:17:54Z")

</div>

Hi

Also during the process I noticed a connection error message

WARNING: intersphinx inventory ‘[https://docs.python.org/2/objects.inv](https://docs.python.org/2/objects.inv)’ not fetch able due to \<class ‘requests.exceptions.SSLError’\>: HTTPSConnectionPool(host=‘do [cs.python.org](http://cs.python.org)’, port=443): Max retries exceeded with url: /2/objects.inv (Caused by SSLError(SSLError(1, ‘[SSL: CERTIFICATE\_VERIFY\_FAILED] certificate verify fa iled (\_ssl.c:600)’),))  
loading intersphinx inventory from …/python2-2.7.13.inv…  
loading intersphinx inventory from [https://docs.python.org/3/objects.inv](https://docs.python.org/3/objects.inv)…  
WARNING: intersphinx inventory ‘[https://docs.python.org/3/objects.inv](https://docs.python.org/3/objects.inv)’ not fetch able due to \<class ‘requests.exceptions.SSLError’\>: HTTPSConnectionPool(host=‘do [cs.python.org](http://cs.python.org)’, port=443): Max retries exceeded with url: /3/objects.inv (Caused by SSLError(SSLError(1, ‘[SSL: CERTIFICATE\_VERIFY\_FAILED] certificate verify fa iled (\_ssl.c:600)’),))

This seems to have occurred as we are behind a firewall. Is there a way to set a proxy or add trusted site in this command?

Thanks  
Jae KIm

---

<div class="post-metadata">

**Author:** ![jborean](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/jborean/32/1525_2.png) [@jborean](https://forum.ansible.com/u/jborean)\
**Post date:** [November 28, 2017, 10:10am UTC](https://forum.ansible.com/t/where-is-the-webdocs-file/26137/9 "2017-11-28T10:10:23Z")

</div>

If you want to just generate the docs for just a single module you can run

> MODULES=file make webdocs

This will generate the docs for the file module as well as the rest of the rst docs. This will save a lot of time as you don’t need to generate the docs for every single module.

Thanks

Jordan
