00:01:27 <paulz2> #startmeeting 00:01:27 <odl_meetbot> Meeting started Wed Apr 2 00:01:27 2014 UTC. The chair is paulz2. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:01:27 <odl_meetbot> Useful Commands: #action #agreed #help #info #idea #link #topic. 00:02:16 <akim> hello 00:02:24 <paulz2> Hi Andrew 00:02:31 <akim> hi paul 00:02:37 <paulz2> Slow day here so far! 00:02:46 <paulz2> Hopefully more will show up shortly. 00:02:48 <akim> yes 00:02:59 <akim> sure np, ill be here 00:04:23 <paulz2> Hi Greg 00:04:58 <gjs_cisco> Hi 00:05:10 <paulz2> #topic agenda 00:05:15 <paulz2> #link https://wiki.opendaylight.org/view/CrossProject:Documentation_Group#Tue.2C_4.2F1.2C_5:00_PM_.28USA_Pacific.29 00:06:32 <paulz2> That's the agenda... hopefully we'll get a few more folks here to discuss. Greg and I talked with Mathieu a little earlier, and he wasn't sure if he was going to make it. In any case, we'll wait for a few and then do a quick runthrough of the agenda if no one else shows. 00:06:53 <paulz2> Alright, Mathieu! 00:06:57 <mlemay> Hi all 00:07:01 <mlemay> (made it) 00:07:02 <mlemay> :) 00:07:31 <paulz2> Small crowd today, but we can get started... 00:08:06 <paulz2> No welcomes or intros needed as we're regulars... 00:08:34 <paulz2> #topic Actions from Last Meeting 00:09:59 <paulz2> I had the action to clean up and submit the Documentation proposal. Done... submitted on March 27 00:10:45 <paulz2> I heard back from Phil Robb... he's going to help with the process. According to the process doc, it has to be posted for 2 weeks for review, so we have another week for folks to look at it. 00:11:34 <mlemay> ok nice 00:13:03 <paulz2> yeah, Mathieu, not sure if we need to include the description of the toolchain... the proposal says we're going to implement one, so I think the details can probably be documented later, as it is set up. 00:13:16 <paulz2> If Phil wants more details, though, maybe we can show a flow or something 00:16:13 <mlemay> ok< 00:16:29 <mlemay> works for me if you need anything let me know 00:16:41 <paulz2> Great, thanks!! 00:16:50 <paulz2> I had one other action from last week.. find out from Rob if we needed to do something for the hackfest. I sent Rob a message but didn't hear back... 00:18:26 <paulz2> The other action from last week was for Mathieu to start documenting the toolchain on the wiki. 00:19:33 <akim> sorry to interrupt, is this the toolkit source? https://bitbucket.org/inocybe/odl-documentation/src 00:21:43 <paulz2> I believe so... Mathieu can confirm. 00:23:01 <mlemay> no 00:23:12 <mlemay> it's the github one 00:23:19 <mlemay> that's really draft documents 00:23:53 <mlemay> https://github.com/inocybe/sdndocs-maven-plugin 00:23:57 <mlemay> that's the plugin 00:24:10 <akim> cool, thanks 00:24:28 <mlemay> if you need access let me know 00:24:35 <mlemay> have my e-mail? 00:24:44 <mlemay> mlemay@inocybe.com 00:24:52 <akim> great 00:25:03 <mlemay> drop me a line or catch me on IRC if you need any changes 00:25:17 <akim> will do 00:25:17 <mlemay> otherwise the source should generate the proper docs (ideally) 00:25:25 <akim> yeah, ill test it out 00:25:47 <mlemay> I am going to fix the asciidoc as soon as I'm done with MD-SAL work so likely next wednesday 00:25:56 <mlemay> ok perfect 00:26:29 <mlemay> I want to extract branding but it is embedded so deeply by rackspace that it will take a while 00:26:52 <akim> you can open up issues in the github repo 00:27:00 <mlemay> yes 00:27:10 <mlemay> will do it right away 00:27:10 <mlemay> 1 sec 00:27:15 <akim> okay 00:27:55 <nzhou> Hi guys 00:28:19 <mlemay> done 00:28:22 <paulz2> sounds like documenting this stuff will be more complete after asciidoc is fixed. 00:28:24 <paulz2> Hi Nan 00:28:26 <mlemay> hi nzhou 00:28:37 <gjs_cisco> Hi Nan 00:29:07 <akim> sure 00:29:15 <akim> yeah, i just did mvn clean install, looking at target 00:29:31 <akim> but not sure how to actually open the documentation, hopefully the wiki will cover this 00:29:42 <mlemay> sure 00:29:46 <akim> anyways, builds fine on my system, so that's good! 00:29:58 <mlemay> it's under target/webhelp 00:30:10 <mlemay> and it'S ready to be automatically uploaded somewhere 00:30:28 <mlemay> one important thing is we should have that docs.opendaylight.org place to put them 00:30:29 <paulz2> That's cool... Andrew, when you're running through the setup, can you put your notes on the wiki? That would be really helpful! 00:30:53 <akim> sure 00:31:13 <paulz2> Yeah, I tried to ping Ed on the repository but he didn't get back to me. I'll try to connect with him again tomorrow. 00:31:14 <mlemay> yea the sdnclouds-maven-plugin is upstreams to maven central.. which why it's not included in the repo (Maven Central rules, signing ,etc..) 00:31:44 <mlemay> (repository or webserver?) 00:33:21 <paulz2> Sorry, docs.opendaylight.org would be the webserver... 00:33:26 <mlemay> yes 00:33:42 <mlemay> wherever that would be hosted 00:34:30 <paulz2> Yeah, we'll need that. I'll talk with Ed and Phil. 00:34:50 <paulz2> #action Paul to talk with Ed & Phil about the server for hosting the docs 00:34:56 <mlemay> perfect we can also work an index page.. 00:35:06 <mlemay> (for the guide and docs) 00:35:16 <paulz2> Sounds good! 00:35:41 <akim> i can help with styling the index page (css), so let me know if you'd like help 00:35:50 <mlemay> I'd love that 00:35:51 <paulz2> Excellent. 00:36:30 <mlemay> I was about to do that (make it darker etc..maybe) but if you which do the changes on the target and send me the css I'll change that 00:36:44 <mlemay> or can give you commit access to the github 00:36:50 <mlemay> whatever you which 00:36:58 <mlemay> *wish 00:37:00 <akim> sure, i can submit a pull request 00:37:19 <paulz2> We kind of moved into the New Business part of the meeting, although it's mainly the ongoing work... just gonna change topics here 00:37:27 <paulz2> #topic Professional Quality Documentation project 00:37:37 <paulz2> Still talking about tool chain though! 00:37:44 <mlemay> k 00:38:01 <mlemay> any wish list for the toolchain? 00:38:25 <mlemay> *other than asciidoc* 00:38:41 <akim> specified question here: so after i do the build, i see /classes/cloud/webhelp and /generated-resources/cloud/webhelp 00:39:27 <akim> so ./classes/cloud/webhelp only has a bunch of xml and xsl files 00:39:43 <mlemay> yea 00:39:44 <akim> just letting you know, not sure how to open these up, ill have to explore a bit more 00:40:07 <mlemay> its in target/webhelp 00:40:39 <mlemay> the rest is really docbkx maven temporary artifacts 00:41:21 <mlemay> the way it works is via the Webhelp Maven Mojo 00:41:36 <akim> which mvn lifecycle do i use? mvn install? i dont see target/webhelp 00:41:48 <mlemay> it's really custom made and create the PDF then applies XSLT by using XProc macros 00:41:59 <akim> i see 00:42:16 <mlemay> there is 2 docbook style sheets (1 for FOP and one for HTML) 00:42:55 <mlemay> (i have no credit for that it was rackspace's ) I'm just trying to organise things, added OPenDaylight branding and fixed things here and there but now making it evolve for our needs 00:43:00 <mlemay> especially on the WADL front 00:43:07 <mlemay> (which generates the API documentation) 00:43:34 <mlemay> haven't finished that yet but it is important (nice looking API documentation outside wiki and version specific) 00:43:51 <mlemay> are you guys ok with this? 00:44:09 <akim> sure, 1 more question, i still dont see target/webhelp 00:44:21 <akim> i did "mvn install", curious which maven lifecycles you use 00:44:59 <mlemay> no target/webhelp? 00:45:04 <mlemay> not normal 00:45:07 <mlemay> I'll look 00:45:32 <mlemay> maybe I haven'T pushed up the latest when I released 00:45:40 <akim> oh okay 00:45:43 <mlemay> but 00:45:45 <mlemay> try 00:45:48 <mlemay> mvn generate-sources 00:45:52 <mlemay> that is where it is attached 00:45:58 <akim> cool 00:46:04 <mlemay> then go in "install-guide) 00:46:13 <mlemay> as it is the only one I currently attached 00:46:38 <mlemay> I need to fix the section ids and formatting as it was done by a newbie 00:46:51 <mlemay> and docbook xml isn'T for humans ;) 00:47:42 <mlemay> I will apply docbk2asciidoc when I am done with the working toolchain and if you guys are ok I'll keep all the manuals I started as asciidoc? is that ok? 00:47:49 <paulz2> This is good that we're working out the setup of the environment... I haven't had a chance to try it yet, so I appreciate that this info is up... great if we can capture it on the wiki! 00:48:08 <paulz2> Yeah, I think that's fine, Mathieu! 00:48:18 <akim> thanks mathieu 00:48:30 <akim> unfortunately, 'mvn generate-sources' didnt create that target/webhelp 00:48:36 <mlemay> ok 00:48:38 <akim> but ill wait for the wiki to go up 00:48:53 <mlemay> akim: Hum ok will you be on IRC tomorrow? 00:49:08 <akim> mlemay, yes ill be here 00:49:10 <mlemay> plz ping me I'll check it out when I am at work 00:49:15 <akim> will do 00:49:24 <mlemay> it should work 00:49:39 <mlemay> or give out an error 00:50:01 <akim> ah 00:50:02 <akim> [WARNING] Failed to obtain description for epub.cover.id 00:50:05 <akim> i see a bunch of these 00:50:24 <mlemay> ah 00:50:31 <akim> lemme post the gist then 00:50:36 <mlemay> ok plz 00:51:00 <paulz2> I made a blank wiki area here to doc our tools 00:51:05 <paulz2> #link https://wiki.opendaylight.org/view/CrossProject:Documentation_Group:Tools 00:51:21 <mlemay> ok 00:51:26 <mlemay> I'll put stuff there 00:51:34 <mlemay> if I forget plz remind me 00:51:45 <mlemay> my agenda is hectic these days 00:52:20 <gjs_cisco> Sorry, I have to drop off now so I can go pick up kids in 8 minutes. I’ll review the minutes later tonight. 00:52:21 <akim> mlemay, https://gist.github.com/andrewkim/9926037 00:52:41 <paulz2> OK, bye Greg 00:53:19 <paulz2> Mathieu, anything we can do to help? If Andrew can put in his steps, that might be a start... 00:54:45 <mlemay> akim: The warning are normal... (these are) also in the rackspace plugin.. I plan to disable them somehow... 00:55:01 <akim> oh okay 00:55:02 <mlemay> they did stress me out when I was facing issues 00:55:02 <mlemay> :) 00:55:09 <akim> haha, i bet 00:55:21 <akim> okay, ill have to just poke around the pom.xml then 00:55:27 <mlemay> ok 00:55:33 <akim> ill ping you tmrw mlemay 00:55:37 <mlemay> ok 00:55:46 <akim> #action akim to sync with mlemay on mvn install issue 00:56:00 <mlemay> shouldn't have to touch it .. I'm trying via my CI server to see if it builds properly 00:56:07 <akim> okay 00:56:34 <paulz2> We're getting close to the end here, but we covered the main things I had on the agenda... the proposal and the tooling... sometime soon, we'll have to start dividing up the content, but first things first! Anything else you want to discuss? 00:56:55 <akim> nope, nothing here 00:57:52 <mlemay> I'm ok for now 00:57:58 <mlemay> thank you guys for all 00:58:27 <mlemay> akim if you can stay 2 secs 00:58:31 <akim> sure 00:58:32 <mlemay> I'll have the CI result in 00:58:59 <paulz2> Thanks to you guys too! I can close out the meeting but obviously that shouldn't affect your chat. 00:59:22 <paulz2> Anything from you, Nan? 00:59:49 <nzhou> No I am fine 01:00:06 <paulz2> OK, great... talk you guys next time (if not before!) 01:00:13 <mlemay> ok 01:00:13 <paulz2> #endmeeting