Re: OFP docs changes


Luis Gomez
 

Dhiraj, can you please push the change to gerrit and share the link so we can take a look?

On Jul 13, 2020, at 9:14 PM, Dhiraj Sharma <dhiraj.8.sharma@...> wrote:


So are you saying current version of sphinx in ODL Jenkins (3.0.4) is not compatible with the tabs plugin? do you have a jenkins rtd job failing for this reason? if so can you share the link?

BR/Luis

Hello Sir, 
 I thought that rtdd jenkins may fail, if I use sphinx tabs as locally tox was emitting error. But the problem was with cached ".tox" which after deletion worked fine but UI is not as expected.


Works just fine with the sphinx-tabs basic example from their site. Here was my quick test with the odl documentation project:


(Although our current bootstrap theme does not appear to render the tabs in a nice way, but it works.)

Dhiraj,

If you already ran docs builds _before_ sphinx-tabs support was merged (tox -e docs) then you need to clear your cache by deleting the .tox directory in the repo. Otherwise it might use the old cached requirements and may not pick up the new tabs support.

Regards,
Thanh

Thank You for the example sir, I worked similarly.The problem was with the stored cached directory of ".tox" which I used to build earlier.
After deleting and then again testing yields the output but the UI is not the same as expected.

Please check below attached screenshots where I tried https://git.opendaylight.org/gerrit/c/docs/+/91311/1/docs/documentation.rst#23 too.
The "code-tab" is also not showing the JSON tab in the below screenshot.
So, even if the UI is not that same should I push the changes?

Thank You
Dhiraj Sharma
<Screenshot (462).png><Screenshot (463).png>

Join integration-dev@lists.opendaylight.org to automatically receive all group messages.