Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-11-01 Thread Colin Dixon
There's a of value in consistency. At the very least, it seems like the autorelease build should produce (maybe as a follow-on job) a complete javadoc site for OpenDaylight in the normal form just so that we have something people are used to. --Colin On Mon, Oct 31, 2016 at 4:11 PM, Robert

Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-10-31 Thread Robert Varga
On 10/31/2016 07:15 PM, Thanh Ha wrote: > It's entirely possible to submit static javadoc api pages as sphinx does > allow for static page publishing but some concerns I have about it (no > necessary blockers or anything) such as the complexity of having more > tools in docs than necessary and

Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-10-31 Thread Thanh Ha
On Mon, Oct 31, 2016 at 9:02 AM, Michael Vorburger wrote: > Sorry for jumping on older thread found while trying to clean up my Inbox: > > On Wed, Oct 12, 2016 at 6:06 PM, Colin Dixon wrote: > >> We have since been able to relax the time limits on our

Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-10-31 Thread Michael Vorburger
Sorry for jumping on older thread found while trying to clean up my Inbox: On Wed, Oct 12, 2016 at 6:06 PM, Colin Dixon wrote: > We have since been able to relax the time limits on our builds in read the > docs to many hours. I think maybe 12, but Phil knows the actual

Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-10-10 Thread Lori Jakab
Hi, Reposting, since Thanh may be back. Meanwhile I had another idea. Alternatively to the maven sites documentation, we could just use directly the new readthedocs infra, since I see that some 'submodules' sites are linked to on the main page. So I guess it may be better to just add the docs

Re: [OpenDaylight Discuss] [documentation] Maven site documentation and docs cross-pollination

2016-10-04 Thread Colin Dixon
This would be a really good thing to get in front of Thanh since he's done most of the work on our maven sites documentation as well as being our local reST/sphinx expert. He's out on PTO this week. --Colin On Tue, Oct 4, 2016 at 8:31 AM, Lori Jakab wrote: > Hi, >