horizon devref has both explicit autodoc directives and
automatically generated source references.
This causes a lot of 'WARNING: duplicate object description'.
I think that we don't need source code references for most modules
and it is better to have explicit API references of modules
for which we need references. Thus this commit removes the logic
to generate source references.
This contributes a lot to reduce the number of sphinx warnings.
Also reduces the required time of documentation build :-)
Reviewed: https:/ /review. openstack. org/374055 /git.openstack. org/cgit/ openstack/ horizon/ commit/ ?id=215ccba9ec2 5d8033f959247af bb3af6a0acf3b5
Committed: https:/
Submitter: Jenkins
Branch: master
commit 215ccba9ec25d80 33f959247afbb3a f6a0acf3b5
Author: Akihiro Motoki <email address hidden>
Date: Tue Sep 20 21:17:20 2016 +0000
doc: Do not generate no source code reference
horizon devref has both explicit autodoc directives and
automatically generated source references.
This causes a lot of 'WARNING: duplicate object description'.
I think that we don't need source code references for most modules
and it is better to have explicit API references of modules
for which we need references. Thus this commit removes the logic
to generate source references.
This contributes a lot to reduce the number of sphinx warnings.
Also reduces the required time of documentation build :-)
Partial-Bug: #1411719 9f4cfd1fff47e81 14d9867e040
Partial-Bug: #1486222
Change-Id: Iba2bf3723cad15