- Jul 31 14:04:52 <add1sun> okey dokey
- Jul 31 14:04:57 <add1sun> hear ye hear ye
- Jul 31 14:05:19 <add1sun> the idea for today's meeting is to get things nailed down a bit
- Jul 31 14:05:25 <add1sun> and start creating action items
- Jul 31 14:05:30 <add1sun> we have the overview at http://drupal.org/node/515870
- Jul 31 14:05:33 <Druplicon> http://drupal.org/node/515870 => Drupal 7 documentation => 4 IRC mentions
- Jul 31 14:05:36 * DaleM (n=dale@S0106002078c5b24f.vn.shawcable.net) has joined #drupal-docs
- Jul 31 14:05:57 <add1sun> i'd like to make a few issues inthe docs queue for things we need to start doing
- Jul 31 14:06:07 <add1sun> so what do we need to do? :p
- Jul 31 14:06:24 <add1sun> first thing on my list s to review the upgrade docs
- Jul 31 14:06:40 <add1sun> and make sure they a) work with 6 > 7
- Jul 31 14:06:53 <add1sun> and b) get a thorough review/cleanup
- Jul 31 14:07:02 <add1sun> we can start this now - no need to wait fr freeze
- Jul 31 14:07:30 <add1sun> i'm assuming install is similar
- Jul 31 14:08:00 <add1sun> anyone interested in adding that to their todo list?
- Jul 31 14:08:01 <JohnAlbin> Depends on if they make any changes the install profiles before code freeze. :-)
- Jul 31 14:08:08 <add1sun> JohnAlbin, indeed
- Jul 31 14:08:20 <add1sun> but i do think that reviewing where we are now is still useful
- Jul 31 14:08:42 <add1sun> and then editing for tweaks after freeze will be easier
- Jul 31 14:09:08 <JohnAlbin> I agree. Personally, I'll be too busy hacking on core until after Sept 1, but getting started now is still a good idea.
- Jul 31 14:09:10 <add1sun> i am also targeting the upgrade docs to be the first real docs in the drupaldocs module
- Jul 31 14:09:21 * Bojhan (n=Bojhan@213-84-190-103.adsl.xs4all.nl) has joined #drupal-docs
- Jul 31 14:09:22 <add1sun> i would like to get that deployed for D6 by the end of August
- Jul 31 14:09:32 <Bojhan> Evening
- Jul 31 14:09:35 <add1sun> allo
- Jul 31 14:09:52 <JohnAlbin> Bojhan: morning!
- Jul 31 14:09:54 <beccascollan> I'm thinking that I should have some initial DITA work to introduce later next week (I hope)
- Jul 31 14:10:04 <add1sun> we also need the core doc issues addressed
- Jul 31 14:10:15 <add1sun> beccascollan, oh that would be rad!
- Jul 31 14:10:43 <add1sun> yeah the timing of getting our docs together vs new IA is a little tight
- Jul 31 14:10:54 <add1sun> which is another reason i'd like to start with existing docs
- Jul 31 14:10:58 <beccascollan> part of it will be identifying unique infotypes, but hopefully there won't be any :)
- Jul 31 14:11:00 <add1sun> and getting them into shae
- Jul 31 14:11:10 <add1sun> rather than creating lots of new book sections
- Jul 31 14:11:29 <beccascollan> well, the first stage will be analysis of what's there, so any thoughts that way will be good
- Jul 31 14:12:09 <add1sun> beccascollan, maybe after our meeting on tuesday we could schedule a public IA/DITA IRC meeting
- Jul 31 14:12:31 <add1sun> so we can get folks to start talking/sharing about it
- Jul 31 14:12:42 <add1sun> but i'll leave that to you to decide if that is useful or not
- Jul 31 14:12:56 <beccascollan> ok, will think on it!
- Jul 31 14:13:00 <add1sun> coolio
- Jul 31 14:13:23 <add1sun> any folks interested in core hacking ;-) can check out the core doc issues
- Jul 31 14:13:32 <add1sun> we have http://drupal.org/project/issues/search/drupal?text=&assigned=&submitted=&participant=&status[]=13&status[]=8&status[]=14&version[]=7.x&issue_tags=Needs+Documentation
- Jul 31 14:13:34 <Bojhan> where is it?
- Jul 31 14:13:39 <add1sun> patches that need docs
- Jul 31 14:13:47 * arianek (n=arianek@69.31.171.162) has joined #drupal-docs
- Jul 31 14:13:57 <add1sun> and these are the core issue, doc component issues: http://drupal.org/project/issues/drupal?text=&status=Open&priorities=All&categories=All&version=All&component=documentation
- Jul 31 14:14:14 <add1sun> as you can see, we have a fair amount of core review/work
- Jul 31 14:14:25 <add1sun> and i'd like to get those lists down in size
- Jul 31 14:15:17 <add1sun> do folks think it would be better to have a few core doc "sprints" between now and drupalcon?
- Jul 31 14:15:27 <add1sun> or just let people pick stuff as they cn/want?
- Jul 31 14:15:41 <add1sun> i'm concerned that many docs people won't go near core
- Jul 31 14:15:48 <add1sun> unless we do a sprint to walk them through it
- Jul 31 14:15:49 <emmajane> I'm always better when I'm scheduled or have a deadline. Otherwise I get too distracted.
- Jul 31 14:16:04 <emmajane> so +1 for sprints from me.
- Jul 31 14:16:08 <add1sun> same here :)
- Jul 31 14:16:44 <sillygwailo> I think I'm the only one who doesn't like sprints
- Jul 31 14:16:49 <add1sun> ok, so anyone willing to be a sprint mentor for that?
- Jul 31 14:17:18 <emmajane> define "mentor"
- Jul 31 14:17:33 <add1sun> 1) show up
- Jul 31 14:17:40 <emmajane> sillygwailo, I just respond well to deadlines. :)
- Jul 31 14:17:54 <add1sun> 2) help answer questions or be willing to go into #drupal to ask questions/introduce people
- Jul 31 14:18:14 <sillygwailo> emmajane: I like the whooshing sound deadlines make as they fly by. :)
- Jul 31 14:18:30 <add1sun> basically we need at least one or two people who have a general feel for how to work on the core issues
- Jul 31 14:18:38 <emmajane> I'm cool with 1 and 2.
- Jul 31 14:18:43 <add1sun> and help new folks feel more comfortable with it
- Jul 31 14:18:46 * emmajane nods
- Jul 31 14:19:04 <add1sun> sweet
- Jul 31 14:19:07 <add1sun> anyone else?
- Jul 31 14:19:17 <add1sun> have an hour or two of time to help with core docs?
- Jul 31 14:19:34 <emmajane> Tuesday and Thursday nights are best for me.
- Jul 31 14:19:34 <rfay> I will
- Jul 31 14:19:44 <DaleM> I'd like to help, but would need some direction
- Jul 31 14:19:59 <add1sun> emmajane, cool, i will let mentors pick the date/time that works for them
- Jul 31 14:20:02 <emmajane> (I'm in EDT, which means it's 2:20PM here)
- Jul 31 14:20:15 <add1sun> DaleM, that would be awesome
- Jul 31 14:20:18 <sillygwailo> DaleM: same here
- Jul 31 14:20:52 <add1sun> well maybe we can do one sprint and emmajane and i can mentor
- Jul 31 14:21:03 <add1sun> and give others a better feel for it
- Jul 31 14:21:07 * emmajane nods
- Jul 31 14:21:24 <add1sun> and then you could take on being a secondary mentor at the next sprint
- Jul 31 14:22:12 <add1sun> OK, well emmajane and i will work out a time for a first sprint and announce it inthe usual channels
- Jul 31 14:22:15 <emmajane> I've put 7PM-9PM EDT Tuesday and Thursday into my calendar for August.
- Jul 31 14:22:22 <add1sun> sweet
- Jul 31 14:22:26 <add1sun> that should work for me too
- Jul 31 14:22:33 <emmajane> Even if I'm a sprint of one that shouldn't be too bad. :)
- Jul 31 14:22:43 <add1sun> :)
- Jul 31 14:22:45 <add1sun> woot!
- Jul 31 14:23:02 * Senpai (n=Senpai@drupal.org/user/65470/view) has joined #drupal-docs
- Jul 31 14:23:16 <add1sun> okey dokey
- Jul 31 14:23:25 <add1sun> so core stuff we'll tackle that way
- Jul 31 14:23:33 <add1sun> as for the actual handbooky stuff
- Jul 31 14:23:49 <add1sun> anyone interested in review/testing of the install and upgrade guides?
- Jul 31 14:24:21 <add1sun> we'd need read through, test, grammar and style guide love
- Jul 31 14:24:38 <add1sun> so i'll make a few issues in the issue queue
- Jul 31 14:24:55 <add1sun> so that folks can work on and keep track of things, claim, etc
- Jul 31 14:25:03 <emmajane> add1sun, andre molnar did a nice D5->D6 upgrade doc. I wonder if I can bribe him into reviewing for D6->D7 in the handbook...
- Jul 31 14:25:13 <emmajane> I'll send him an email and ask.
- Jul 31 14:25:22 <add1sun> emmajane, that would be splendid
- Jul 31 14:25:27 <sillygwailo> I'm interested in review/testing
- Jul 31 14:25:36 <add1sun> i am also totally open to rewriting if it is needed
- Jul 31 14:26:02 <add1sun> sillygwailo, great
- Jul 31 14:26:06 <sillygwailo> of course, I'll end up writing a "how to do installs and upgrades properly using CVS" :P (separately, since I know that FTP is more commonly understood than CVS)
- Jul 31 14:26:15 <add1sun> lol :p
- Jul 31 14:26:26 <add1sun> that would still be awesome
- Jul 31 14:26:54 <add1sun> sillygwailo, do you think you'd be able to pick a section and be able to review it within the next two weeks?
- Jul 31 14:27:12 <sillygwailo> yeah. is this D6 -> D7?
- Jul 31 14:27:19 <add1sun> sillygwailo, yep
- Jul 31 14:27:31 <sillygwailo> groovy
- Jul 31 14:27:33 <add1sun> basically see what/if anything changed
- Jul 31 14:27:36 <add1sun> and noting that
- Jul 31 14:27:47 <add1sun> while also making sure the existing stuff isn't stupid
- Jul 31 14:27:47 <emmajane> sillygwailo, I'm CCing you on the email to Andre.
- Jul 31 14:28:20 <add1sun> we should prolly make an issue in the queue for this just to track
- Jul 31 14:29:02 <add1sun> anyone handy to just make a quick issue for review upgrade docs (http://drupal.org/upgrade/)?
- Jul 31 14:29:53 <add1sun> oh alright
- Jul 31 14:29:56 <add1sun> i'll do it
- Jul 31 14:30:20 <add1sun> does anyone else have a burning desire for what they'd like to work on?
- Jul 31 14:30:34 <add1sun> or just still confused about wth we are doing? :p
- Jul 31 14:30:34 <rfay> I'll be happy to work with docs on core patches.
- Jul 31 14:30:54 <add1sun> rfay, do you want to mentor up a sprint?
- Jul 31 14:31:14 <add1sun> you can pick the date/time
- Jul 31 14:31:25 <add1sun> and i'll make sure you've got at least one other person to help
- Jul 31 14:31:28 <rfay> Well, sure. But since I'm a newby that seems like perhaps a stretch :-) I can do it if you like.
- Jul 31 14:31:37 <add1sun> rock on
- Jul 31 14:31:48 <add1sun> well if emmajane and i do a sprint on tues evening
- Jul 31 14:31:56 <add1sun> would you be able to make that?
- Jul 31 14:32:00 <emmajane> rfay, it's not as scary as it sounds. :)
- Jul 31 14:32:05 <add1sun> then after that you won't be a newbie :)
- Jul 31 14:32:30 <rfay> Monday 8/3 evening US time for core patch docs? (I'm Mountain)
- Jul 31 14:32:32 <JohnAlbin> add1sun: after code freeze, I'm up for docblock stuff or any core documentation really. And my "burning desire" item is getting theming tutorials written.
- Jul 31 14:32:46 <add1sun> JohnAlbin, sweet
- Jul 31 14:32:57 <add1sun> JohnAlbin, we will definitely be swining into full gear after freeze
- Jul 31 14:33:02 * vordude (n=vordude@c-75-70-207-112.hsd1.co.comcast.net) has joined #drupal-docs
- Jul 31 14:33:02 <add1sun> so there will be plenty to do
- Jul 31 14:33:22 <add1sun> JohnAlbin, you are going to paris?
- Jul 31 14:33:26 <rfay> add1sun, the other think I can do is development if there are issues with your new modules.
- Jul 31 14:33:57 <add1sun> rfay, we will definitely be making an all call for devs in the next month or so i think
- Jul 31 14:34:06 <add1sun> also, i should just mention
- Jul 31 14:34:17 <add1sun> that we have begun the official process to get docs.drupal.org
- Jul 31 14:34:20 <add1sun> as a subsite
- Jul 31 14:34:24 <emmajane> WOO!
- Jul 31 14:34:40 <add1sun> so we will have a fresh new site for the new IA that beccascollan is helping us bring about
- Jul 31 14:35:03 <add1sun> i hope to get all the keys to the kingdom and wrap my head around it
- Jul 31 14:35:05 <beccascollan> :)
- Jul 31 14:35:06 <add1sun> before Drupalcon
- Jul 31 14:35:07 <JohnAlbin> add1sun: yep. I'll be there all 5 days. Maybe leaving mid-afternoon on Saturday
- Jul 31 14:35:07 <DaleM> I'm interested in helping on DITA stuff, have ref impl installed and am doing a bit of playing
- Jul 31 14:35:29 <beccascollan> great!
- Jul 31 14:35:30 <Druplicon> Why, Drupal of course!
- Jul 31 14:35:39 <add1sun> JohnAlbin, yay!
- Jul 31 14:36:06 <emmajane> I sent in my notes for my interview with sillygwailo. I didn't see a place to put them on the docs test site?
- Jul 31 14:36:24 <emmajane> JohnAlbin, awesome!
- Jul 31 14:36:25 <add1sun> emmajane, hrm, there should be a create interview or something
- Jul 31 14:36:52 * add1sun totally failed on the interview upload process stuff
- Jul 31 14:36:58 <Bojhan> add1sun: will the new site, comply to the design of new d.o?
- Jul 31 14:37:09 <add1sun> Bojhan, yes, we will implement the redesign
- Jul 31 14:37:11 <sillygwailo> my interview notes with emmajane are forthcoming. maybe I should just send the raw notes?
- Jul 31 14:37:16 <add1sun> in so far as it applies to docs
- Jul 31 14:37:22 <emmajane> sillygwailo, I just sent in raw notes.
- Jul 31 14:37:28 <add1sun> Bojhan, in terms of theming and being a subsite with consistent nav
- Jul 31 14:37:32 <Bojhan> add1sun: so we are free in the wind to change, anything else?
- Jul 31 14:37:42 <add1sun> but not in terms of IA which wasn't really done for docs frankly
- Jul 31 14:37:56 <Bojhan> add1sun: no but I mean like book pages, layout stuff like that
- Jul 31 14:38:23 <add1sun> Bojhan, we will use the redesign as a guideline, but i am not married to implementing it exactly
- Jul 31 14:38:34 <add1sun> cuz i don't think it addresses a lot of our needs
- Jul 31 14:38:36 <Bojhan> add1sun: pfiew, oke :)
- Jul 31 14:38:57 <beccascollan> I'd like to keep the top level task-oriented nav
- Jul 31 14:39:01 <add1sun> Bojhan, ha, yeah, my goal is to rock the docs, not squeeze them into the redesign ;)
- Jul 31 14:39:09 <beccascollan> but otherwise, build it ground up with DITA
- Jul 31 14:39:29 <beccascollan> and do some testing later on for additional nav
- Jul 31 14:39:31 <JohnAlbin> Mark Boulton intended the redesign docs be guidelines, not straight-jackets.
- Jul 31 14:39:37 <add1sun> yep yep
- Jul 31 14:39:49 <add1sun> and they knew they kinda gave docs a pass
- Jul 31 14:39:54 <add1sun> since they didn't have time
- Jul 31 14:40:02 <emmajane> I get a little bit stressed out when people say DITA. I think we mean, "task-focused documentation" but not necessarily DITA XML.
- Jul 31 14:40:19 <emmajane> Can people clarify what they mean when they use the term DITA?
- Jul 31 14:40:19 <add1sun> emmajane, well maybe
- Jul 31 14:40:34 <beccascollan> talking about darwin
- Jul 31 14:40:35 <add1sun> emmajane, yes, task-based structure
- Jul 31 14:40:40 <JohnAlbin> Can people clarify what the acronym DITA means? :-D
- Jul 31 14:40:49 <add1sun> but i srsly want to look at bulding tools for web front to XML
- Jul 31 14:41:01 <beccascollan> "darwin information typing architecture"
- Jul 31 14:41:06 <add1sun> Druplicon, DITA is http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
- Jul 31 14:41:07 <Druplicon> add1sun: Okay.
- Jul 31 14:41:08 <emmajane> beccascollan, Yaeh, I know what it is but I'm *very* leery of adopting a new tech just because it sounds interesting. :/
- Jul 31 14:41:22 <beccascollan> hehe, don't worry
- Jul 31 14:41:43 <beccascollan> in the end, we'll do what we can do, not follow any system exactly
- Jul 31 14:42:01 <add1sun> emmajane, yeah i think how we implement is still a ways off
- Jul 31 14:42:02 <beccascollan> but the underlying theory I think is a godd one
- Jul 31 14:42:04 <DaleM> emmajane IMO it would solve a whole layer of management issues the project is being crushed under
- Jul 31 14:42:21 <DaleM> But yes, would create a whole new set of issues to deal with :-)
- Jul 31 14:42:39 <beccascollan> which is why i need more interviews!
- Jul 31 14:42:57 <beccascollan> I'd like them to learn how people work, so we don't create something out of wack
- Jul 31 14:43:51 <emmajane> I just want to make sure that I understand how people are using the term. I get a little nervous when any tech is seen as a solution.
- Jul 31 14:44:41 <beccascollan> I've been focusing on the theory of it, how the information is structured - not any specific tech
- Jul 31 14:44:42 <emmajane> (And this is coming from someone who *likes* DocBook and semantic markup.)
- Jul 31 14:45:05 * emmajane nods to beccascollan. That's cool and makes sense.
- Jul 31 14:45:49 <beccascollan> it's not the most exciting reading tho :)
- Jul 31 14:45:53 <emmajane> I think using the FLA "DITA" may also scare off some people because the confusion of whether or not they have to learn something new to contribute to docs. But "task-centric" or "task-focused" docs doesn't imply tech.
- Jul 31 14:46:38 <beccascollan> part of the problem, with the the environment we have, is creating an easy to use back-end
- Jul 31 14:46:43 * emmajane steps down off of her terminology soapbox. :)
- Jul 31 14:46:50 <beccascollan> and something that most people can contribute too
- Jul 31 14:47:05 <beccascollan> so we'll see - that's my primary concern with it all
- Jul 31 14:47:34 <add1sun> but emmajane DITA is easier to type ;)
- Jul 31 14:47:40 * bmadore has quit ()
- Jul 31 14:47:44 <add1sun> fyi, http://drupal.org/node/536854
- Jul 31 14:47:45 * emmajane chuckles.
- Jul 31 14:47:46 <Druplicon> http://drupal.org/node/536854 => Review and test the upgade guide for Drupal 7 => Documentation, Other documentation issues, normal, active, 1 IRC mention
- Jul 31 14:47:51 <add1sun> sillygwailo, ^^
- Jul 31 14:47:54 <sillygwailo> if there a DITA iPhone app?
- Jul 31 14:48:12 <beccascollan> that would rule
- Jul 31 14:48:20 <add1sun> ha!
- Jul 31 14:48:55 <add1sun> OK, so anyone else have anything they want to add?
- Jul 31 14:49:15 <add1sun> i'll create more issues
- Jul 31 14:49:27 <add1sun> and write this up and post it tomorrow
- Jul 31 14:49:54 <add1sun> i'll also probably do a blog post about the overall effort
- Jul 31 14:49:58 <add1sun> beginning of next week
- Jul 31 14:50:31 <add1sun> OK, so if nothing else for now, thanks for coming!
- Jul 31 14:50:48 <add1sun> i'll put up a doodle for the next meeting
- Jul 31 14:51:05 <add1sun> and we'll look to meet again in about 2 weeks
- Jul 31 14:51:28 <DaleM> Is the IA/Dita public meeting also going to happen?
- Jul 31 14:51:37 <DaleM> or is it waiting?
- Jul 31 14:51:52 <add1sun> DaleM, beccascollan and i will sort that out next tuesday
- Jul 31 14:52:27 <add1sun> DaleM, so if it does happen you'll here about that next week or so
- Jul 31 14:52:56 <arianek> whoa hi - just happening upon what looks like a meeting here! hi add1sun :-)
- Jul 31 14:53:17 <arianek> i've been eyeing up that drupal cookbook section of the handbook... is that a useful thing to spend some time on?
- Jul 31 14:53:47 <add1sun> arianek, i'd say that right now, probably not
- Jul 31 14:53:56 <Bojhan> add1sun: there is one thing, one second
- Jul 31 14:53:58 <add1sun> since we are getting ready to rethink a lot
- Jul 31 14:54:05 <arianek> ah fair enought
- Jul 31 14:54:06 <sillygwailo> hi arianek!
- Jul 31 14:54:08 <arianek> (enough
- Jul 31 14:54:16 * z3cka1 (n=z3ckaub@nv-71-2-213-25.sta.embarqhsd.net) has joined #drupal-docs
- Jul 31 14:54:17 <arianek> hi richard :-)
- Jul 31 14:54:35 <Bojhan> add1sun: http://drupal.org/node/501452
- Jul 31 14:54:36 <Druplicon> http://drupal.org/node/501452 => User interface best practices => 4 IRC mentions
- Jul 31 14:54:39 <add1sun> arianek, we just awrapped a meeting about D7 docs
- Jul 31 14:54:41 <arianek> ok, i'm sort of out of the loop on docs these days, i'll try and read up on what's been going on and keep an eye out for sprints so i can help out a bit
- Jul 31 14:54:51 <arianek> ya i was skimming the log there!
- Jul 31 14:54:55 <add1sun> arianek, woot
- Jul 31 14:54:58 <arianek> lots to catch up on tho ;-)
- Jul 31 14:55:08 <add1sun> Bojhan, yah?
- Jul 31 14:55:21 <arianek> add1sun hope you're feeling better too btw!
- Jul 31 14:55:22 <add1sun> arianek, i'll be posting a lot about where we are and what needs done
- Jul 31 14:55:23 <Bojhan> add1sun: i't be nice to get a review and maybe some work on that.
- Jul 31 14:55:26 * z3cka1 has quit (Client Quit)
- Jul 31 14:55:28 <add1sun> over theweekend/next week
- Jul 31 14:55:31 <arianek> add1sun awesome
- Jul 31 14:55:46 <add1sun> arianek, i am! not quite full health but not as bad now
- Jul 31 14:56:27 <add1sun> Bojhan, feel free to create an issue
- Jul 31 14:56:33 * bmadore (n=bmadore@curie.advantagelabs.com) has joined #drupal-docs
- Jul 31 14:56:36 <arianek> add1sun hope you get time to rest up and get all the way better! i'll keep an eye out see where i can help.
- Jul 31 14:56:45 * Bojhan is not familiair with the process, how do I create an issue on that?
- Jul 31 14:57:07 <add1sun> Bojhan, just an issue in the docs queue
- Jul 31 14:57:08 <add1sun> http://drupal.org/node/add/project-issue/documentation
- Jul 31 14:57:16 <Bojhan> okw
- Jul 31 14:57:16 <add1sun> asking for review, explaining what you want
- Jul 31 14:57:55 <add1sun> arianek, at least no flying for a few weeks, so yeah i'm getting more rest than normal :)
- Jul 31 14:58:04 <arianek> gooooooood
- Jul 31 14:59:05 <add1sun> oh also!
- Jul 31 14:59:14 <add1sun> i created an issue tag for d7 dc issues
- Jul 31 14:59:18 <add1sun> http://drupal.org/project/issues/search/documentation?issue_tags=d7docs
- Jul 31 14:59:35 <add1sun> feel free to use that on issues that are specific to d7 that we need to keep an eye on
- Jul 31 15:00:16 <add1sun> ok folks
- Jul 31 15:00:19 <add1sun> i gotta run
- Jul 31 15:00:23 <add1sun> but thanks again :)
Posted by add1sun on Sun 2 Aug 15:11
report abuse | download | new post
Submit a correction or amendment below (click here to make a fresh posting)
After submitting an amendment, you'll be able to view the differences between the old and new posts easily.