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