fluid-work IRC Logs-2011-09-08

[08:27:45 CDT(-0500)] <heidi_> anastasiac i'm cool with reviewing the fss instructional demo to start
[08:28:02 CDT(-0500)] <anastasiac> heidi_, great, thanks
[08:28:41 CDT(-0500)] <heidi_> Justin_o my car brakes went out i can email transfers you some lottery $
[08:28:50 CDT(-0500)] <heidi_> maybe i'll win a new car
[08:31:45 CDT(-0500)] <anastasiac> fluid-everyone, good morning! It's Docs Sprint day! We've got a list of tasks on the planning page: http://wiki.fluidproject.org/display/fluid/Docs+Sprint+September+2011
[08:32:34 CDT(-0500)] <anastasiac> please have a look at the planning page, and let me know what you'll be working on. If you have any questions, ask here in the channel.
[08:35:07 CDT(-0500)] <anastasiac> fluid-everyone: new documentation should go in the docs space: http://wiki.fluidproject.org/display/docs/Infusion+Documentation I'm also interested to know how well people are able to navigate the docs space
[08:35:26 CDT(-0500)] <huslage> w00t
[08:41:15 CDT(-0500)] <cindyli> anastasiac: there's an ATutor emergency issue that I'm looking into right now. I will let you know once I'm done with it and start on docs sprint.
[08:41:30 CDT(-0500)] <anastasiac> cindyli, no problem - thanks for letting me know
[08:48:10 CDT(-0500)] <anastasiac> Justin_o, are you working from home today?
[08:51:50 CDT(-0500)] <Justin_o> anastasiac: i'm here now
[09:08:56 CDT(-0500)] <anastasiac> so michelled, what are you planning on working of first for the docs sprint?
[09:09:16 CDT(-0500)] <michelled> I'm going to look at the renderer decorators
[09:09:42 CDT(-0500)] <anastasiac> excellent, thanks
[09:09:54 CDT(-0500)] <anastasiac> Justin_o, what were you thinking of starting with for the docs sprint?
[09:12:07 CDT(-0500)] <Justin_o> anastasiac: not sure.. did you have anything you'd like me to do
[09:12:42 CDT(-0500)] <anastasiac> Justin_o, yes, there are a few suggestions on the planning page: http://wiki.fluidproject.org/display/fluid/Docs+Sprint+September+2011 I've put your name beside some things I think you might be able to help with, but they're just suggestions
[09:14:20 CDT(-0500)] <anastasiac> yura, I'm hoping you can help out with the docs sprint today. There are a couple of areas that your experience would be helpful with: A general guide/tutorial on how to create something using IoC, and framework debugging guide.
[09:14:23 CDT(-0500)] <Justin_o> cindyli: are you looking after the uio api stuff?
[09:14:45 CDT(-0500)] <anastasiac> cindyli is actually working on an atutor emergency right now
[09:14:53 CDT(-0500)] <anastasiac> hopefully she'll be able to join us soon
[09:15:04 CDT(-0500)] <cindyli> yes, hopefully
[09:15:17 CDT(-0500)] <yura> anastasiac: definitely , as soon as i commit changes to 1 cspace JIRA and branch
[09:15:22 CDT(-0500)] <anastasiac> james, I'm also hoping that you'll be able to help out with the docs sprint a bit today
[09:15:23 CDT(-0500)] <yura> should be done shortly
[09:15:45 CDT(-0500)] <anastasiac> jameswy: ^
[09:15:52 CDT(-0500)] <anastasiac> yura, thanks
[09:16:16 CDT(-0500)] <Justin_o> cindyli: okay.. thanks..
[09:18:45 CDT(-0500)] <heidi_> hey anastasiac for this page http://wiki.fluidproject.org/display/fluid/FSS+Columns+-+Equal-width+columns%2C+fixed-width+container - is there anyway to specify in the TOC to the left that we're currently on the first page? a 'current' style or something?
[09:20:13 CDT(-0500)] <anastasiac> heidi_, unfortunately not with the current way that I've implemented it in confluence, no - I'm loading in an external file rather than duplicating the list in several pages. I know it's not ideal. If you can think of any confluence tips or tricks that might help, that would be great
[09:20:43 CDT(-0500)] <Justin_o> anastasiac: i guess i'll start with the component grades one
[09:20:44 CDT(-0500)] <anastasiac> I suppose the other alternative, heidi_, is to go ahead and duplicate the list of pages on each page. harder to maintain, but better usability
[09:20:52 CDT(-0500)] <anastasiac> Justin_o, thanks
[09:21:04 CDT(-0500)] <heidi_> anastasiac gotcha. i'll brainstorm. just think it would help orient the user a bit better. there's a lot on here
[09:21:10 CDT(-0500)] <jameswy> anastasiac: Sure thing. What in particular about the docs sprint?
[09:22:19 CDT(-0500)] <anastasiac> jameswy, you could have a look at the 'new' docs space, with is an attempt at a migration toward the proposed design. Feedback on usability, navigation, etc. We'll eventually be migrating to a new platform, but in the meantime, it would be good to make sure what we've got is ok
[09:30:04 CDT(-0500)] <jameswy> anastasiac: Fantastic! Will do.
[09:30:10 CDT(-0500)] <anastasiac> great, thanks
[09:38:43 CDT(-0500)] <anastasiac> Justin_o, a question about the refectored table of contents component: There are a few new functions on the 'that' and I'm not sure if they're intended to be publicly documented: headingTextToAnchor(), insertAnchor(), anchorInfo(), filterHeadings()
[09:40:37 CDT(-0500)] <Justin_o> anastasiac: what was the general convention about this.. in regards to what should and shouldn't be publicly documented
[09:40:38 CDT(-0500)] <Justin_o> ?
[09:44:12 CDT(-0500)] <heidi_> anastasiac Justin_o what do you think about html5-ing our sample code? i'm thinking <header> and <footer> for the fss for ex
[09:44:25 CDT(-0500)] <anastasiac> Justin_o, my understanding is that if we think integrators might want/be able to use it, we should explain how, and if the functionality is not really expected to be used by integrators, then we shouldn't
[09:45:58 CDT(-0500)] <Justin_o> heidi_: i don't mind that generally but we will have to do some things to make sure that it works with older versions of IE.. I have some code in my github repo that does this, but we should also make sure the default styling is set too
[09:46:17 CDT(-0500)] <anastasiac> heidi_, could you show me an example of what something would look like once it's html5-ified?
[09:46:18 CDT(-0500)] <Justin_o> anastasiac: that makes sense.. i'll review them
[09:46:40 CDT(-0500)] <anastasiac> heidi_ i.e. one of the fss examples you're thinking of
[09:47:29 CDT(-0500)] <heidi_> anastasiac so for http://wiki.fluidproject.org/display/fluid/FSS+Columns+-+Equal-width+columns%2C+fixed-width+container ...the top and bottom divs would be <header> and <footer> instead of <div> - would help semantically. but yeah, IE might not like it so maybe not yet...
[09:48:14 CDT(-0500)] <anastasiac> heidi_, IE is an issue, definitely
[09:48:43 CDT(-0500)] <anastasiac> but the semantics would help
[09:49:40 CDT(-0500)] <heidi_> anastasiac also considering the col colours... wondering if something like this would be clearer to look at: http://www.456bereastreet.com/lab/developing_with_web_standards/csslayout/2-col/finished.html
[09:50:11 CDT(-0500)] <anastasiac> heidi_, certainly, much better!
[09:50:25 CDT(-0500)] <heidi_> but this is minor stuff i should prob speed up and help out with more important things..ha
[09:50:51 CDT(-0500)] <anastasiac> heidi_, if you want to try to improve the styling of the fss examples, they're all defined here:
[09:50:52 CDT(-0500)] <anastasiac> http://wiki.fluidproject.org/display/fluid/Styles+for+FSS+examples
[09:51:21 CDT(-0500)] <heidi_> ah cool, ok!
[10:34:44 CDT(-0500)] <anastasiac> heidi_, are you joining stand-up today?
[10:34:56 CDT(-0500)] <heidi_> oops yes
[11:03:12 CDT(-0500)] <anastasiac> so yura, are you up for teaching people to use IoC after lunch?
[11:03:32 CDT(-0500)] <yura> that's right
[11:03:52 CDT(-0500)] <anastasiac> excellent! We do have existing docs on IoC, including a "how to use" but it's extremely high-level, and probably a bit out of date, to boot
[11:04:20 CDT(-0500)] <anastasiac> guidelines, examples, et. for someone who wants to create an IoC app would really be great
[11:04:58 CDT(-0500)] <anastasiac> maybe before you could have a look at what we already have, and after lunch we can talk a bit about how to approach this
[11:05:04 CDT(-0500)] <anastasiac> yura: http://wiki.fluidproject.org/display/docs/Inversion+of+Control+%28IoC%29 and child pages
[11:05:26 CDT(-0500)] <yura> thanks i was looking for them
[12:01:50 CDT(-0500)] <cindyli> anastasiac: i'm done with atutor issue and ready to take on a docs sprint task. which would you suggest? is Justin_o looking after uio api docs?
[12:02:06 CDT(-0500)] <cindyli> **which one
[12:02:38 CDT(-0500)] <anastasiac> cindyli, no, Justin_o is looking at the component grade docs. If you could review what I have so far for the various UIO components, that would be great
[12:03:14 CDT(-0500)] <cindyli> cool. i will do it. thanks, anastasiac
[12:03:23 CDT(-0500)] <anastasiac> thanks, cindyli
[12:03:38 CDT(-0500)] <cindyli> np
[12:03:52 CDT(-0500)] <anastasiac> cindyli, also: any feedback on the way the documentation is structured (what with subcomponents and all that) would be appreciated
[12:04:11 CDT(-0500)] <cindyli> sure
[12:44:07 CDT(-0500)] <heidi_> anastasiac for http://wiki.fluidproject.org/display/fluid/FSS+Advanced+Layout+-+Icons , did the hc (now wb) theme replace icons before?
[12:44:23 CDT(-0500)] <heidi_> er, bw
[12:46:47 CDT(-0500)] <anastasiac> heidi_, good question. I think in the context of this particular page, no: this page is about the icon styling that can be applied to any small square icon, so the high contrast themes can't know what to swap. For specific known icons (like the widget), yes, it should swap them
[12:47:01 CDT(-0500)] <anastasiac> does that make sense?
[12:47:49 CDT(-0500)] <heidi_> anastasiac hm, i thought it would swap the image for text. ie. hide the image
[12:48:59 CDT(-0500)] <anastasiac> ah, I see. I don't think it does that. Well, obviously, it doesn't do that. The question is, should it? maybe jameswy can weigh in on this (again, I think)
[12:49:05 CDT(-0500)] <anastasiac> I'm sure I've asked him this before
[12:51:21 CDT(-0500)] <jameswy> anastasiac, heidi_: the contrast themes are for offering alternate contrasts--not for textifying graphics. Current behaviour is good.
[12:51:35 CDT(-0500)] <anastasiac> thanks, jameswy
[12:53:34 CDT(-0500)] <heidi_> anastasiac so what is the themed section of the icon page demonstrating exactly? i'm guessing hc used to swap images, but now doesn't
[12:54:10 CDT(-0500)] <anastasiac> heidi_ good point. It would probably make sense to remove that part now
[12:54:33 CDT(-0500)] <heidi_> okay will do, tho it would be nice to illustrate the icon hiding thing... ill see if any other themes do that
[13:06:38 CDT(-0500)] <Justin_o_> anastasiac: can you check out the "Useful functions and events" section http://wiki.fluidproject.org/display/docs/Renderer+Components
[13:06:55 CDT(-0500)] <anastasiac> thanks, Justin_o, I'll have a look
[13:07:28 CDT(-0500)] <anastasiac> this looks pretty good, Justin_o
[13:09:16 CDT(-0500)] <heidi_> Justin_o i just noticed all the .fl-theme-yb in the fl-theme-by file ... is this... good?
[13:09:43 CDT(-0500)] <Justin_o_> heidi_: for the inversion stuff?
[13:09:56 CDT(-0500)] <heidi_> Justin_o ya
[13:11:20 CDT(-0500)] <Justin_o_> heidi_: for now, but when we go through our cleanup of the themes we should try to improve on that too
[13:12:13 CDT(-0500)] <heidi_> Justin_o themes knowing about each other seems odd... if i'm using one theme, it's strange ot have extra styles unrelated to it included
[13:12:36 CDT(-0500)] <heidi_> i would think the inverted stuff should stya in yb
[13:12:47 CDT(-0500)] <heidi_> even if it's the same as the by
[13:12:51 CDT(-0500)] <Justin_o_> heidi_: i understand what you mean.. it was decided to do that so that we could get the inversion working without having to duplicate the styles from one theme within another
[13:13:04 CDT(-0500)] <Justin_o_> so that was the trade off
[13:13:14 CDT(-0500)] <Justin_o_> but if we can simplify the themes this shouldn't be an issue
[13:13:17 CDT(-0500)] <heidi_> hm, i don't see it as duplication
[13:13:52 CDT(-0500)] <Justin_o_> if we had them all in yb you would basically have all the styles from by in there too, but just scoped for inversion
[13:14:06 CDT(-0500)] <heidi_> i think that makes mroe sense
[13:14:45 CDT(-0500)] <heidi_> tho i don't really get inversion - why wouldn't you just use the opposite theme? instead of the same theme with opposite colours?
[14:16:42 CDT(-0500)] <Justin_o> heidi_: sorry.. didn't see your last comment
[14:17:05 CDT(-0500)] <Justin_o> that's for the tab bar for example in fat panel.. sometimes in a theme you really need the opposite colours
[14:17:11 CDT(-0500)] <Justin_o> but it depends on your use i guess
[14:17:22 CDT(-0500)] <Justin_o> anyways we could do a better job in 1.5 i think
[14:31:51 CDT(-0500)] <heidi_> Justin_o cool yeah, till 1.5!
[14:38:00 CDT(-0500)] <heidi_> anastasiac is fl-clearfix documented anywhere yet? i can add it to the FSS Advanced Layout - Layout Fix page
[14:39:15 CDT(-0500)] <anastasiac> heidi_, I believe I added it to the FSS Cheat Sheet page, but yes, adding it to that demo page would be great, thanks
[14:39:24 CDT(-0500)] <anastasiac> the cheat sheet it just that, it's not a demo
[14:40:44 CDT(-0500)] <anastasiac> mlam, could you give me a run-down of what you've been doing for the docs sprint?
[14:41:05 CDT(-0500)] <mlam> hey anastasiac, checking over your UIO tutorials
[14:41:17 CDT(-0500)] <anastasiac> excellent, thanks
[14:41:23 CDT(-0500)] <mlam> np
[14:42:25 CDT(-0500)] <heidi_> anastasiac will add to demo, np
[14:42:39 CDT(-0500)] <anastasiac> thanks, heidi_
[14:43:19 CDT(-0500)] <anastasiac> yura, do you have any ideas for a tutorial/guide on creating apps using IoC?
[14:50:43 CDT(-0500)] <yura> creating apps ?
[14:51:26 CDT(-0500)] <yura> anastasiac: do you have examples what sort of apps ?
[14:52:09 CDT(-0500)] <anastasiac> anything! I guess that's the question: what's the answer to "what kind of scenario would I use IoC for?"