[06:40] good morning [06:41] need to go to the vet, text me if there's anything important [10:52] linkedin just told me that I've been working at Canonical for 8 years now :) [10:52] holy cow - how time flies [10:52] dholbach, wow [10:52] Nice [13:28] hey mhall119 [13:28] I have an idea [13:29] scarier words have never been said [13:29] What's up jcastro ? [13:29] cjohnston: exactly my thought :P [13:29] well for documenting the API part of developer.u.c [13:29] cjohnston: where in the world are you? [13:29] marcoceppi: are you around? [13:30] (.. today) [13:30] jcastro: aye [13:30] nigelb: Lexington right now [13:30] what's up nigelb!! [13:30] I think [13:30] marcoceppi: ok check this out [13:30] http://pad.ubuntu.com/gj3WVIVV7Q [13:30] so I am documenting the "get-relation" and so on [13:31] cjohnston: :) [13:31] /23/36 [13:31] jcastro: just dropping by and saying hi :) [13:31] cjohnston: lol [13:31] jcastro: cool [13:31] jcastro: what's your idea? [13:31] mhall119: so what I was thinking [13:32] was get this skeleton up now [13:32] so I can get people to fill in the blanks [13:32] ok... [13:32] let me file up a few things [13:32] hold on [13:33] jcastro: you can just give them your etherpad link and have them fill it in there [13:34] yeah [13:34] but I was thinkign if we can get a skeleton up on 91.whatever it'll help visualize to people what we are trying to do [13:34] "hey guys go fill in this etherpad" ... marco will be like, what? Lame. [13:34] mhall119: or do like, one, I just need an example [13:35] I gave you an example [13:35] in the etherpad [13:35] no I mean it rendered [13:35] on the site [13:35] oh. give me the pad link agian and I'll grab what's there [13:36] http://pad.ubuntu.com/gj3WVIVV7Q [13:36] top one is fine [13:36] the rest I'll "flesh them out a little bit" [13:36] heh, see what I did there? [13:37] jcastro: wow, that sounded like management :) [13:38] jcastro: are these meant to be accurate? [13:38] no [13:38] that's a template [13:38] okay [13:38] what I am doing is making the template so you guys can fill it in [13:38] ack [13:38] or ... if you know how to find the flags and shit to each one [13:38] I can do that too [13:39] jcastro: debug-hooks in to a unit, trip a hook, run the command with the --help flag [13:39] wow that kind of ugly, actually [13:39] http://91.189.93.79/api/Charms/13.10/Juju/juju_log/ [13:39] ya'll need some css [13:39] marcoceppi: anthony dillon gave me some already, I need to integrate it with the current codebase [13:40] I also need to refactor some data models to fit juju better [13:40] mhall119: oh, I stupidly forgot to close some H2s [13:40] fixed [13:40] jcastro: ok, that looks better :) [13:40] marcoceppi: so I need to figure out how to find the flags and arguments for each one, any idea how to do that? [13:40] thumper gave me some pointers but it's all "first learn go, then go here", then 45 minutes of him talking to himself [13:41] jcastro: debug-hooks in to a unit, trip a hook, run the command with the --help flag [13:41] jcastro: also I need to know how Juju tracks versioning, is it per-Ubuntu-release or do you have your own versioning that you refer to? [13:41] own versioning [13:41] so what's the current version/ [13:41] ? [13:41] 1.13 is unstable, 1.12 and 1.14 are stable [13:41] mhall119: we have our own versions, however internal tools that are being documented will not change [13:41] 1.12 currently, 1.14 will be in saucy [13:42] marcoceppi: do I even need to trip a hook? [13:42] mhall119: atleast not drastically, at best we may add another tool. [13:42] jcastro: marcoceppi: link is now http://91.189.93.79/api/Charms/1.14/Juju/juju_log/ [13:42] jcastro: you need to be in a hook environment,the tools are not in path [13:42] marcoceppi: excellent, so .. deploy like mysql or something, debug-hooks .... then ? [13:43] jcastro: one sec, going to make this even easier for you [13:43] jcastro: marcoceppi: I need something to distinguish different hooks available in different releases, that's all [13:43] that would be <3 [13:43] mhall119: you probably won't need that from us for a long time. [13:43] so if you add a new hook next year, it would have it's own URL space separate from the ones now [13:43] but by then we'll sort out how to generate this stuff from juju itself from the versioned docs themselves [13:43] jcastro: well I need it for the other APIs, so I need to map Juju to it somehow [13:43] I get that [13:43] bahhh, tools are too smart for now [13:44] mhall119: I am giving talks in OLF all day tomorrow, so today is all about just getting the stuff up there. [13:44] then on monday I can get yelled at by the core guys. [13:44] but that's like, a whole 4 days away [13:44] OLF starts tomorrow, not Saturday? [13:44] ubucon is tomorrow [13:45] ah, ok [13:45] gl jcastro [13:45] gotta hit the road at 6am [13:45] fun [13:45] OLF is awesome, I need to get around users for a while [13:45] oh > mi :-p [13:45] been in this little bubble too long [13:46] up in the clouds [13:47] marcoceppi: man, the local provider is so fast now [13:47] it's like, I have this half-finished openstack deployment in like 15 containers ... [13:47] jcastro: you on 1.13.3? [13:48] or 1.15? [13:48] 1.13.3 [13:49] marcoceppi: I can do whatever unholy thing you need if it helps [13:49] jcastro: you're going to have to use debug hooks, it's just a fact of life [13:50] jcastro: just want to make sure I give you the right information [13:50] yeah that's fine, I don't mind doing the legwork [13:51] just as long as the output is correct [13:52] marcoceppi: ok I am in debug hooks [13:52] jcastro: http://paste.ubuntu.com/6097098/ [13:53] dude ... ! [13:53] mhall119: dude, thumper was wrong [13:53] they _DO_ document it right there [13:53] ok ... that's good to know for long term [13:53] jcastro: for future reference, get in to debug hooks, run juju set mysql/0 tuning-level='fast', inthe config change hook, run the commands with --help [13:54] jcastro: yeah, they have help output for all of their commands, but you can't run those 8 commands without being in a hook environment [13:54] GOT IT. [13:55] jcastro: it's only because thumper hates you and is anti-community :) [13:55] it's because canonical hates the community [13:55] jcastro: http://i.imgur.com/YSVmR32.gif [13:55] marcoceppi: lol [13:55] marcoceppi: oh, I need to be in not 0 in tmux [13:55] I *heard* that jingle too, in my head [13:55] argh, how do you move to the next tab in raw tmux? [13:56] jcastro: Ctrl + A, Space [13:56] jcastro, let me paste that everywhere, and see how people treat you:) [13:56] hmm, still not in the path, I am in myaql/0:config-changed [13:56] jcastro: they are definitely there, try running unit-get --help [13:57] oh duh [13:57] I don't need the ./ [13:57] marcoceppi: AWESOME, I am all set. thanks! [13:57] mhall119: I should have this done in an hour or so [13:57] jcastro: yeah, I was in /var/lib/juju/tools/1.13.*/, just so I knew all the commands [13:58] yeah so this is way better than reading the source code [13:58] jcastro: duh ;) [13:59] mhall119: how flexible am I with the headers [13:59] like if I want to change "arguments" to "options" [13:59] I mean flags to options [13:59] jcastro: mhall119 due to compatibility issues, these will almost always be the same, so it's the same options as it's been since like 0.3 of juju. There have been a few enhancments, but there will never be a compatibility break [14:03] mhall119: ok so I think I can trim down my sections to just [14:03] Usage and Examples, and Options [14:05] jcastro: you can do whatever you want in that chunk of HTML [14:05] but if you use an iframe I will find you, and I will kill you [14:08] marcoceppi: my examples will be badass too [14:08] jcastro: they better be. [14:10] marcoceppi: I am just searching for each one in the store and stealing from real hooks [14:10] marcoceppi: surely you will add more hooks at some point in the future [14:11] mhall119: these aren't hooks, they're tools used in hooks. I don't forsee new ones being add in the near future [14:11] mhall119: but it's fiesable. Though it'll always be additions, never subtractions [14:13] right [14:13] these are more like busybox than bash [14:13] :) [14:13] that's how I think about it [14:19] marcoceppi: check out my open-port examples son [14:19] http://pad.ubuntu.com/gj3WVIVV7Q [14:19] lines 57-69 [14:20] dayumn [14:20] examples with other commands. [14:20] that's like a new thing in unix tools. COMMON SENSE. [14:20] jcastro: you should link those other commands to their help pages [14:20] jcastro: for total pwnage [14:21] oooh, where are their help pages? [14:21] jcastro: arent' you making them right now? [14:21] yeah [14:21] oh, you mean cross-links? [14:21] yes [14:21] mhall119: oooh, I can do that right? [14:21] or will each page show on the sidebar anyway? [14:21] marcoceppi: ok after I get them all done and deployed, then I'll get fancy [14:23] jcastro: which pages are you talking about? [14:24] the ones I am writing [14:24] when they are split into individual pages [14:24] for wordpress or the API site? [14:24] API [14:24] you can cross link, but the full URL path isn't final yet [14:24] ok [14:24] you should be able to link to peer-level pages though [14:25] using relative paths [14:25] nod [14:25] after I get the initial cut done I'll do that next [14:25] so ./open-port/ from juju-log would work [14:25] marcoceppi: lol: pub_addr=`unit-get private-address` [14:25] though you can't use hyphens currently, I need to fix that [14:30] jcastro: ha, perfect example [14:32] hey dpm [14:32] hi jono [14:32] what is the current status of the d.u.c Landing/Overview pages? [14:32] that I mailed about yesterday [14:34] jono, I'm still on it. I'm updating the get started sections to be overview and now I'm working on the Apps landing page [14:35] jcastro: marcoceppi: hyphens are allowed now: http://91.189.93.79/api/Charms/1.14/Juju/juju-log/ [14:35] \o/ [14:36] only 4 commands left! [14:36] then my API section is D O N E. [14:37] mhall119: when this goes live, we can give ubuntu teams write access right? [14:38] so if I do like "ok I've got basic examples of most of the commands, but I need you guys to fill in some brutal advanced examples" they can do so? [14:38] dpm, cool [14:38] thanks dpm [14:38] jcastro: no, these parts should be statis and auto-generated going forward [14:39] * jcastro nods [14:39] ok, so we'll just make them commit the examples to the --help sections then [14:39] jcastro: *but*, the new site will allow community additions, such as extra advanced examples [14:39] snippets, tutorials, etc [14:39] actually, it's stupid of me to even bring it up the first time, nm. [14:39] * jcastro nods [14:40] jono, you should see more visible updates in a couple of hours. I've also been coordinating with the Scopes, Cloud (and later on today) Web/HTML team around the requirements to get their docs on d.u.c. You should see the status on the document I shared. [14:56] marcoceppi: hah kill me [14:56] marcoceppi: I wrote up a bunch of examples [14:56] and just stumbled on mims' way awesomer than mine examples I could have just ripped off [14:56] jcastro: that's what you get for trying too hard [15:02] hey mhall119 [15:02] hey jcastro [15:02] http://pad.ubuntu.com/gj3WVIVV7Q [15:02] done. [15:02] dpm: ok, what page is next? [15:02] for Cloud? [15:08] jcastro: http://91.189.93.79/api/Charms/1.14/Juju/ [15:09] jcastro: your htmlneeds a little more love [15:09] http://91.189.93.79/api/Charms/1.14/Juju/relation-get/ [15:09] yeah [15:09] I see that [15:09] use

 instead of 
[15:10]  use both, actually
[15:10]  jcastro: pre is preformatted and will display as a block element, code is inline-block
[15:10]  mhall119's template had 
[15:10]  
[15:10]  oh dude!!
[15:10]  got it
[15:10]  mhall119: not semantic
[15:10]  mhall119: and not recommended
[15:10]  last I checked
[15:10]  marcoceppi: probably not, no
[15:10]  mhall119: I can just fix it in WP
[15:10]  it's not in WP jcastro
[15:10]  oh
[15:10]  ok, so you want me to fix it in etherpad?
[15:11]  also, would it be easier to push this to lp or something?
[15:11]  I guess  is okay, the internet is still divided on this
[15:11]  jcastro: do whatever mhall119 says to
[15:11]  marcoceppi: that debug-hooks thing saved me so much time you have no idea!
[15:12]  marcoceppi: I think the CSS for the main developer portal makes  display: block anyway
[15:12]  but it doesn't preserve whitespace
[15:13]  mhall119: that's not the case in the page you linked
[15:13]  he hasn't added the CSS yet
[15:13]  jcastro: ah
[15:13]  yeah, working on functionality first
[15:14]  marcoceppi: don't ask too many questions, you might end up assigned to fix everything you point out
[15:14]  Welcome to Ubuntu!
[15:14]  :p
[15:14]  * marcoceppi slinks back to working on packaging
[15:15]  mhall119: ok so  for each code block?
[15:15]  marcoceppi, same as me here (packaging)
[15:16]  jcastro: that works for now, yes
[15:18]  mhall119: ok all set
[15:18]  ah, I need some 's in there
[15:19]  jcastro: are you editing the django entry or the etherpad?
[15:20]  django
[15:21]  man, it's so hilarious how horribly spoiled Markdown makes you
[15:22]  http://91.189.93.79/api/Charms/1.14/Juju/relation-get/
[15:22]  mhall119: ok so I've 
'ed up the stuff, but there's a lack of whitespace after the codeblocks, is that a CSS fixable thing?
[15:24]  jcastro: you mean spacing below the code block?
[15:24]  yeah
[15:25]  yeah, I can fix that in CSS later
[15:26]  ok
[15:26]  so how's that look?
[15:27]  jcastro: looks great!  thanks man
[15:30]  hey dpm I kind of have 2 Landing pages
[15:30]  http://91.189.93.79/cloud/get-started/
[15:30]  http://91.189.93.79/cloud/what-is-a-juju-charm/
[15:30]  not sure which one should be the real landing page
[15:30]  /cloud/ is your landing page
[15:34]  jcastro, as Mike says: the landing page is /cloud
[15:34]  jcastro, get-started I'm going to rename to overview to be consistent with the rest of the site
[15:34]  ok
[15:35]  and we can merge what-is-a-juju-charm into overview
[15:35]  let me do this real quick to give you something to start on
[15:42]  does anyone else on saucy get double notifications?
[15:43]  dpm: yeah but it's important to remember that overview isn't just for charms
[15:43]  it'll be for simplestreams, MAAS, and charms, and whatever else we're working on
[15:46]  jcastro, ah, I thought we were just doing charms on d.u.c. In any case, could you sync with evilnick? After our call this morning he told me he didn't know we were moving those docs to d.u.c
[15:46]  I am syncing with him now
[15:47]  cool
[16:02]  <-- lunching
[16:54]  jcastro, sorry, I got sidetracked and never answered your question on landing page. Can we have a call once you're done with lunch?
[16:54]  and I can't write either. I meant on the /cloud/ landing page
[16:54]  dpm: fire it up! I'm ready
[16:56]  ok, cool, setting up the hangout
[16:58]  jcastro, https://plus.google.com/hangouts/_/cb747b5837d16513c965faf0cbdf2dfa0ce87e01