# HG changeset patch # User Steve Losh # Date 1274891664 14400 # Node ID 79b5e20cd96a5866db2ccbaca9ed356ff5a47d98 # Parent 2ffdbbd7baa10bb6007d2f2c8554c1959c2a2a48 vim: add vimkata diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/ftdetect/kata.vim --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/ftdetect/kata.vim Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,1 @@ +/Users/sjl/lib/dotfiles/vim/notreallybundles/vimkata/ftdetect/kata.vim \ No newline at end of file diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/ftplugin/kata.vim --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/ftplugin/kata.vim Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,1 @@ +/Users/sjl/lib/dotfiles/vim/notreallybundles/vimkata/ftplugin/kata.vim \ No newline at end of file diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/INSTALL --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/INSTALL Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,7 @@ +I haven't created a proper plugin for this project yet. +For now, create the following symlinks to the corresponding files in this tree: + +~/.vim/ftdetect/kata.vim +~/.vim/ftplugin/kata.vim +~/.vim/syntax/kata.vim + diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/README --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/README Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,51 @@ += VimKata: The path to Vim Mastery + +VimKata is a series of exercises specially graded to progressively develop your +skills in the venerable vim editor. + + Tell me and I'll forget; + Show me and I may remember; + Involve me and I'll understand. + -- Chinese Proverb + +VimKata assumes the student has taken VimTutor before and feels somewhat comfortable with the concepts there. Our objective is to bring the student from the basic lessons learned in VimTutor to a place of mastery--both of the VimTutor concepts as well as more advanced concepts. + +VimKata is intended to unite the discipline of martial arts to the methods of modern science. The premise for the learning style of VimKata is what psychologists call "Deliberate Practice" which: + + - is explicitly intended to improve performance + - reaches for objectives just beyond one's level of competence + - provides feedback on results + - involves high levels of repetition + +(These 4 takeaways are from "What it takes to be great". See also the original paper, "The Role of Deliberate Practice in the Acquisition of Expert Performance.") + +The VimKata moves through 6 belts: white, yellow, green, blue, red and black. After the 6 belts, there will be even more detailed kata for further development (e.g. kata for the NERD Comment plugin, other plugins, etc.) + +The project is currently maintained by Duane Johnson and Barry Arthur. + +== Quick Start + +Once installed, diving into VimKata is as simple as: + + :VimKata + +where is a color such as white, yellow, green, blue, red, or black. + +== Resources + +=== Website: + +http://github.com/canadaduane/VimKata + +=== Katas: + +http://github.com/canadaduane/VimKata/blob/master/vim_1_white.kata + +=== Bug Tracker / Wiki: + +http://github.com/canadaduane/VimKata/issues + +=== Source Code: + +http://github.com/canadaduane/VimKata + diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/chatlogs/VimKata_freenode_chat_20100523.log --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/chatlogs/VimKata_freenode_chat_20100523.log Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,500 @@ +**** BEGIN LOGGING AT Sun May 23 01:53:01 2010 + +May 23 08:25:25 yeah i'm glad you found that stack overflow thread +May 23 08:25:49 kind of puts some objections out there for us to consider +May 23 08:26:09 so... +May 23 08:26:36 what do you think of my thoughts written on the github wiki? +May 23 08:26:44 i have no objections +May 23 08:29:42 naming scheme sounds good - i like the story idea +May 23 08:30:01 ok +May 23 08:30:11 as for vim_1.p et al, I think we can have multiple indexes +May 23 08:30:22 you suggest something similar with your helptags idea +May 23 08:30:38 yeah, well, I have a question about this area +May 23 08:30:48 i have no objections to unfolded questions +May 23 08:31:03 do we want to lump all functionality of each type of task into one practice session, or spread them out? +May 23 08:31:09 have you ever used anki? +May 23 08:31:15 for example, if we have "folding" in chapter 1 +May 23 08:31:17 (no) +May 23 08:31:25 should we have "advanced folding" in chapter 2? +May 23 08:31:32 or keep all folding practice in chapter 1 +May 23 08:31:37 no +May 23 08:31:46 definitely progress with the belts +May 23 08:31:52 ok, good +May 23 08:31:56 advanced folding should reappear in a higher belt level +May 23 08:32:25 I was thinking our objective should be to provide basic skills, and then tie them together in useful task-oriented ways +May 23 08:32:26 as an aside, folding may not even appear in level 1 +May 23 08:32:42 yes, that may be a good idea :) +May 23 08:32:46 kind of like vimtutor? +May 23 08:32:50 yes +May 23 08:32:57 sounds good +May 23 08:33:15 hmm... I wonder +May 23 08:33:49 so what I mean by task-oriented, is we could find clever ways to use things together, such as "comment this block of code" and "tab this block of code over by 2" +May 23 08:33:53 (or whatever) +May 23 08:34:05 each nugget is a separate concept, sometimes standalone, sometimes related to other concepts +May 23 08:34:07 then we get the benefit of wiring our skills up together in the brain +May 23 08:34:11 right +May 23 08:34:20 I would like to be able to thread concepts in different ways +May 23 08:34:26 but that might not be easy to achieve +May 23 08:34:27 yes, me too +May 23 08:34:36 right, because there are so many options +May 23 08:34:45 let's say we have a big pool (right) of concepts +May 23 08:35:05 yeah, basic concepts +May 23 08:35:16 and then related concepts +May 23 08:35:17 we might create a vim_1.p that has some of those concepts +May 23 08:35:29 for some reason this reminds me of a game like Mortal Kombat or something +May 23 08:35:31 and then a vim_patterns.p that has some of the same concepts plus others +May 23 08:35:38 where you learn some basic punches and kicks +May 23 08:35:43 and then get powerful with the combos +May 23 08:35:44 lol +May 23 08:35:57 (hehe... haven't played games since 2nd year in uni ^_^ ) +May 23 08:36:14 but the story is powerful +May 23 08:36:20 and if people want to think of it like that +May 23 08:36:25 then it will help their learning +May 23 08:36:28 which is all good +May 23 08:36:46 what is vim_patterns.practice? (sorry, I didn't quite understand) +May 23 08:36:55 pattern matching +May 23 08:37:03 I was thinking of having separate paths +May 23 08:37:11 oh, I thought we were going to move away from topics +May 23 08:37:11 one path might be for newbies +May 23 08:37:14 in the filenames? +May 23 08:37:19 numbered as in vim_1, _2, etc +May 23 08:37:50 other paths might be names after the concepts they teach (for more advanced users who now know *what* they want to focus on) +May 23 08:37:57 named* +May 23 08:38:01 Ah, I see +May 23 08:38:15 so we have the color belts for the first round, then separate tracks? +May 23 08:38:24 well... in martial arts +May 23 08:38:29 the colours are for newbies +May 23 08:38:40 even black? +May 23 08:38:46 the black belts have their own separate ranks, called dans +May 23 08:38:52 oh, ok +May 23 08:38:53 usually around 9 dans +May 23 08:39:37 we don't have to copy that exactly, but maybe the named threads could be considered for either advanced users... +May 23 08:39:45 idea: why not use .vimkata as the filetype? +May 23 08:39:47 or a different way to approach the learning +May 23 08:39:55 for example, what level do you or I jump in at? +May 23 08:40:01 Are we a 2 or a 3 or a 4? +May 23 08:40:11 I know I wanna know more about x, though... +May 23 08:40:11 I'm not sure +May 23 08:40:16 I see +May 23 08:40:26 hmm +May 23 08:48:49 ok, so I think I'm following your plan +May 23 08:49:00 basically we'll have a bunch of "beginner" files +May 23 08:49:03 yep +May 23 08:49:16 and they can just be numbered +May 23 08:49:16 but these will become fairly broad in topics, as you suggested in the original txt file +May 23 08:49:20 (and coloured) +May 23 08:49:49 and then we'll branch off into more advanced topics from there +May 23 08:49:54 so what should the filetype be? +May 23 08:50:04 .vimkata? .practice? .vimpractice? +May 23 08:50:13 .kata +May 23 08:50:26 I like it +May 23 08:50:32 short and simple :) +May 23 08:50:33 sorry - that was just a brainstorm +May 23 08:50:39 not concrete :-) +May 23 08:50:41 but yes +May 23 08:50:43 it is short +May 23 08:50:47 and to the point... +May 23 08:50:50 does it clash? +May 23 08:51:25 i think it goes well with the project name +May 23 08:51:47 agreed +May 23 08:53:13 how long should it take to do a kata file (for the user)? +May 23 08:53:35 hmm... good question... +May 23 08:53:42 20 min? +May 23 08:53:44 it will depend on the grade, of course +May 23 08:53:48 seems reasonable +May 23 08:53:56 just asking around. hangon. +May 23 08:54:23 anki sets a 20 min learning session by default +May 23 08:54:24 also, is that time target for the "first time" or the "last time"? +May 23 08:54:27 my wife suggests 15 - 20 +May 23 08:54:34 good point +May 23 08:54:57 hmm.. +May 23 08:55:03 so maybe for intermediate +May 23 08:55:05 i'd say that should be the learn time... +May 23 08:55:14 the goal time should be *much* quicker +May 23 08:55:16 right? +May 23 08:55:25 right +May 23 08:56:16 I think we could say something like this though: "Each kata will take you about 20 minutes, but possibly longer for your first attempt. If you reach 5 minutes or less, you've mastered it." +May 23 08:56:28 that sounds good +May 23 08:57:02 so this time target actually limits us quite a bit with our "belts" idea +May 23 08:57:09 what we can pack into 20 minutes for a beginner +May 23 08:57:13 maybe +May 23 08:57:18 might not be the full scope of everything you mentioned in the .txt +May 23 08:57:30 but anyway, I think it's a good target +May 23 08:57:34 so we should work with it +May 23 08:57:36 no - just have less nuggets in the file +May 23 08:57:38 and split things out as necessary +May 23 08:57:45 agreed +May 23 08:58:46 as you go up in levels, your skills will be improving, so you're faster at doing the simpler things (covered in lower belt levels) +May 23 08:59:10 right +May 23 08:59:11 good point +May 23 08:59:19 Great! I'm pumped +May 23 08:59:26 this is going to be really useful +May 23 09:00:38 me too. It sounds good. I've wanted to do a project like this for a while now +May 23 09:00:49 I never thought it would be based on vim, though. lol +May 23 09:00:54 heh +May 23 09:01:04 I mean, I've wanted to do an OSS project +May 23 09:01:05 oh, btw, I have seen anki before +May 23 09:01:13 I haven't used it, but something similar called spicy elephant +May 23 09:01:18 cool. I use it to study Chinese +May 23 09:01:24 nice +May 23 09:02:01 i was dreaming of incorporating some of the spaced repetition algorithms into our learning paths +May 23 09:02:51 wow, that would be quite something... in vim +May 23 09:03:01 hey so the github issue tracker has upvoting +May 23 09:03:04 so i was thinking... +May 23 09:03:14 we could go around the vim wiki collecting tidbits +May 23 09:03:19 and also invite others to help out +May 23 09:03:36 and then use the issue tracker as a way of both voting on what should be included and making corrections +May 23 09:03:37 you might have to explain more - upvoting? +May 23 09:03:41 ok +May 23 09:03:42 ic +May 23 09:03:53 not at first of course +May 23 09:03:58 we need to make a skeleton ourselves +May 23 09:04:02 agreed +May 23 09:04:08 but the community has so much to offer here +May 23 09:04:18 we might go through a few iterations before we're happy +May 23 09:04:24 I am a very small "vim user" :) +May 23 09:04:28 let's do that inside the fence before inviting a crowd :-) +May 23 09:04:34 sounds good +May 23 09:04:49 i have spoken to some of the #vim gurus about deliberate practice +May 23 09:04:54 and it falls on deaf ears +May 23 09:05:05 interesting, but that's fine +May 23 09:05:06 but I think, if we build it, they will come :-) +May 23 09:05:21 they don't have to recognize a great thing until it slaps them in the face +May 23 09:05:22 hehe +May 23 09:05:26 what you said +May 23 09:05:28 :) +May 23 09:05:48 So it sounds like my original file format is going to work pretty much as is? +May 23 09:05:56 We'll keep the answers folded +May 23 09:05:59 but the questions open +May 23 09:06:00 oh +May 23 09:06:02 one thing +May 23 09:06:05 sure +May 23 09:06:12 not sure if I like the leading > in the answers... +May 23 09:06:16 wanna explain the point? +May 23 09:06:31 it was only for making it a different color +May 23 09:06:47 the folded answer block not obvious enough? ;-) +May 23 09:06:47 but I'm happy with anything that makes it easy to read and differentiate +May 23 09:07:29 Actually, there might be a good use for some kind of marker +May 23 09:07:40 I noticed you provided some alternate answers +May 23 09:07:44 and that made sense to me +May 23 09:07:53 I think we should have a "canonical" answer +May 23 09:07:57 and then 1 or 2 alternates +May 23 09:07:59 yep - I'd like to separate them - so it's clear they are alternates +May 23 09:08:04 fine +May 23 09:08:04 right +May 23 09:08:06 sounds good +May 23 09:08:12 so maybe that could be the purpose of color coding there +May 23 09:08:32 how should we designate the lines that are "canonical"? with a ">" ? +May 23 09:08:32 one colour for the definitive answer? a separate colour for alternates? +May 23 09:08:37 right +May 23 09:08:41 that's what I was thinking +May 23 09:08:44 urgh.... lemme think about it... +May 23 09:08:47 can I just dump a few crazy ideas I've had about this on you? I'm not suggesting that we can implement all of these, or maybe any... +May 23 09:08:53 sure +May 23 09:08:58 idea 1: +May 23 09:09:08 executing the definitive answer +May 23 09:09:14 do this on the 'practice' block +May 23 09:09:23 as a demonstration of workingness +May 23 09:09:32 crazy idea 2: timing +May 23 09:09:46 have the user start his practice session which kicks off a timer +May 23 09:09:57 when he's done, he's shown the time +May 23 09:10:21 there are more CI, but when I explain one, the others flee :-) +May 23 09:10:31 heh +May 23 09:10:53 I like idea 1 +May 23 09:10:58 idea 2, not sure if it's important +May 23 09:11:43 idea 2: hmm... only in that it might serve as nice feedback. Well done, you're 3 minutes under your personal best today! that sort of thing... +May 23 09:11:58 I see +May 23 09:12:14 initially I didn't like your > because I thought it might clash with idea 1 +May 23 09:12:20 but now I see it will actually help +May 23 09:12:27 so, liking the > now :-) +May 23 09:12:56 what I meant was it might not be important for us to implement as part of the practice since people can time themselves +May 23 09:13:04 but maybe as a feature later on... +May 23 09:13:15 of course +May 23 09:13:33 you know what +May 23 09:13:35 I take that all back +May 23 09:13:38 timing is really important +May 23 09:13:44 that's one of the reasons DP works +May 23 09:13:50 ok +May 23 09:13:53 that sounds fair +May 23 09:13:56 you have to have a clear objective +May 23 09:14:05 what are we trying to help users do? lower their time +May 23 09:14:25 ok - an objectives brainstorm +May 23 09:14:33 lower times +May 23 09:14:39 increase knowledge +May 23 09:14:43 (skills) +May 23 09:15:27 right +May 23 09:15:29 identify bad habbits +May 23 09:15:34 and correct them +May 23 09:16:00 hmm... just had another crazy idea... but it reminds me too much of the paperclip to even utter it :-) +May 23 09:26:28 you mentioned taking stuff from the vim wiki, which I fully agree with. This vim tips page also has an unordered mess of useful nuggets too: http://rayninfo.co.uk/vimtips.html +May 23 09:26:49 but we'll want to be... judicious about checking our facts. +May 23 09:28:12 some of the #vim gurus criticise the vim wiki as being populated by newbies as they discover a new vim trick, quite often not showing the full story or abusing a tool for an unintended purpose (missing the canonical tool vim does provide for that purpose) +May 23 09:28:24 just saying, we need to make sure we're promoting good practice +May 23 09:28:34 best, even, where appropriate +May 23 09:37:28 back +May 23 09:37:42 I agree with everything you said while I was away :) +May 23 09:38:12 so your talk of objectives reminded me of a "touch typing" course I took in high school +May 23 09:38:21 it was actually very much like this DP idea +May 23 09:38:25 and it had some similar objectives +May 23 09:38:53 I had forgotten about the "identify bad habits"-related objective of "minimizing typing mistakes" +May 23 09:38:58 I think this is an important one as well +May 23 09:39:03 agreed +May 23 09:39:08 the way they integrated the idea +May 23 09:39:13 was by penalizing the time for mistakes +May 23 09:39:28 so if you were typing at a good 90 WPM but made several mistakes and had to back up and re-type +May 23 09:39:32 you were double-penalized +May 23 09:39:33 i think there is a lot of overlap with these ideas over the years, but I hadn't put them together until recently - reading Ericsson's stuff +May 23 09:39:42 right +May 23 09:39:53 Can you point me to a link? +May 23 09:39:57 and that was my last crazy idea - of having vim 'watch' you and comment... +May 23 09:40:08 but like I said, paperclip territory. :-/ +May 23 09:40:44 yes, we'll have to see +May 23 09:41:31 is it possible to create a vim plugin like you seek? +May 23 09:41:47 Compiled C code perhaps? +May 23 09:42:11 I guess it doesn't really matter what language it's in +May 23 09:42:18 C might be better for pure portability purposes +May 23 09:42:21 do you Ruby? +May 23 09:42:24 yeah +May 23 09:42:31 cool +May 23 09:42:44 Vim plugins can be written in Ruby? +May 23 09:42:56 maybe we could cut early stuff in ruby - as a good... (yep) proving ground +May 23 09:43:06 interesting +May 23 09:43:15 you'll have to lead the way there, but I'm intrigued +May 23 09:43:16 https://wincent.com/products/command-t +May 23 09:43:48 nice +May 23 09:43:49 sorry, a better link would be: https://wincent.com/blog/bringing-textmate-style-command-t-to-vim +May 23 09:44:17 and some good Ericsson links: http://www.hooversbiz.com/2008/04/14/deliberate-practice-in-the-working-world/ +May 23 09:44:50 great! thanks +May 23 09:45:03 wow, this is really good stuff, plugins +May 23 09:45:09 I hadn't realized how much you could do +May 23 09:45:13 learning vimscript has been my latest project +May 23 09:45:26 but I will be learning to write Ruby plugins in vim too +May 23 09:45:41 I intended to use Wincent's plugin as a guide +May 23 09:45:47 perhaps we could learn each other :-) +May 23 09:46:09 Ruby is my preferred language +May 23 09:47:08 Damian Conway has a great vimscript series here: http://www.ibm.com/developerworks/linux/library/l-vim-script-1/index.html +May 23 09:47:17 i'm eagerly awaiting number 6 - plugins :-) +May 23 09:48:14 (aside: someone just posted this gem on #vim: http://stackoverflow.com/questions/1218390/what-is-your-most-productive-shortcut-with-vim/1220118#1220118) +May 23 09:48:28 nice +May 23 09:49:26 so I have one more question for discussion +May 23 09:49:29 ok +May 23 09:49:37 What should we do about the infinite customizations that people make? +May 23 09:49:38 for example, +May 23 09:49:58 I realized that my practice file for NERD Comment includes a reference to the '?' key +May 23 09:50:04 which I remapped to mean "toggle comment" +May 23 09:50:12 in visual momde +May 23 09:50:13 mode +May 23 09:50:17 hmm... we *should* stick to vanilla vim +May 23 09:50:32 I have seen this before (Blender), where all the tutorials are given on a vanilla install +May 23 09:50:45 I think the Ubuntu community does something similar +May 23 09:50:47 so no kata for plugins? +May 23 09:50:51 no +May 23 09:50:53 not saying that +May 23 09:51:01 kata for plugins is fine +May 23 09:51:11 so vanilla vim = (vim + plugins) without customizations +May 23 09:51:15 yep +May 23 09:51:19 k +May 23 09:51:21 that makes sense +May 23 09:51:39 if there are customisations, then the kata should be explicit about them +May 23 09:51:52 say, given the map blah, use it to do blah +May 23 09:52:00 Right +May 23 09:52:16 so I will have to take that part out of the nerd comment kata +May 23 09:52:38 but every kata that uses that map should mention it (either explicitly, or implicitly through a Dependencies chain) +May 23 09:53:04 I wonder... can we auto-source the dependent kata... +May 23 09:53:11 so the maps are inherited +May 23 09:53:36 might shelve that idea for now. +May 23 09:53:40 sounds complicated +May 23 09:54:40 alright, so plan of attack +May 23 09:54:58 Should we focus entirely on the kata first? +May 23 09:55:03 yep +May 23 09:55:09 we need to create a test case +May 23 09:55:14 that we can throw rocks at +May 23 09:55:19 that's our core +May 23 09:55:24 let's get it working +May 23 09:55:30 what do you mean by test case? +May 23 09:55:39 a single kata +May 23 09:55:56 that serves as a test of the engine: file format, supporting plugin code, etc +May 23 09:56:20 like your suggested vimtutor kata +May 23 09:56:37 question about terminology: is a "kata" a group of practices (i.e. a .kata file) or is a "kata" a single question/answer? +May 23 09:56:50 kata = group +May 23 09:56:54 i was thinking +May 23 09:57:00 ok +May 23 09:57:14 I see +May 23 09:57:14 a kata contains a set of related steps +May 23 09:58:16 ideally, related +May 23 09:58:39 so - as your issue tracker says: we need our first kata +May 23 09:59:30 we can also start building a plugin that supports kata mode +May 23 10:00:32 the 'plugin' doesn't have to be fancy at this stage - it's nothing more than the practice.vim (renamed to kata.vim ?) that we've been playing with, along with some autocmd stuff so .kata files are recognised +May 23 10:00:44 oh, and the syntax file +May 23 10:01:00 yeah, that syntax file I wrote is pretty rudimentary +May 23 10:01:04 I don't really know much about vim :) +May 23 10:01:07 that's ok +May 23 10:01:15 we can put what we have together for now +May 23 10:01:19 and stepwise refine it +May 23 10:01:28 release early, release often! :-) +May 23 10:01:41 sounds like a good philosophy +May 23 10:01:46 :) +May 23 10:02:00 it's one of the OSS mantras +May 23 10:02:12 ok +May 23 10:02:20 so, which part do you want to focus on? +May 23 10:02:24 yes, sorry, it's hard to communicate subtlety +May 23 10:02:45 I'd be happy to start the first kata based on vimtutor +May 23 10:02:52 I'm sure I will learn some more just by doing it +May 23 10:03:06 cool. I look forward to doing your first kata. :-) +May 23 10:03:19 I'll have a look at bundling the plugin code then +May 23 10:03:30 ok +May 23 10:03:53 Oh, and I'll switch the code and filenames we have so far to reflect the change to ".kata" +May 23 10:03:57 any idea how long vimtutor takes a newbie to complete? +May 23 10:04:05 I wonder how long it takes me to do... +May 23 10:04:12 the name switch sounds good +May 23 10:04:14 It took me about a half hour +May 23 10:04:29 ok. I'll do it later and see how I go. +May 23 10:05:27 so you'll need to have slightly less than the vimtutor file for your kata, yeah? So it stays around 20 mins... +May 23 10:05:49 right +May 23 10:06:17 just had a look - it says it should take 25-30 mins +May 23 10:06:48 Is the license open enough that we can do what we want with it? +May 23 10:06:57 for vimtutor? +May 23 10:07:03 Should I begin our "story" ? +May 23 10:07:06 yeah, vimtutor +May 23 10:07:21 just looking now... no mention of license +May 23 10:07:31 k +May 23 10:07:36 probably the same as vim then +May 23 10:07:48 probably +May 23 10:07:52 GPL compatible +May 23 10:08:02 three authors are mentioned at the bottom +May 23 10:08:05 including Bram +May 23 10:08:18 there's an email +May 23 10:08:32 if you're worried, you could drop him a line - he might even like the kata idea... +May 23 10:09:00 might as well, it would be courteous at the least +May 23 10:09:03 bware, I mean, not Bram +May 23 10:09:12 what's the email? +May 23 10:09:29 bware@mines.colorado.edu +May 23 10:09:33 thx +May 23 10:09:41 np +May 23 10:14:08 How will we license our project? +May 23 10:14:14 GPL compatible? +May 23 10:14:20 You mentioned CC +May 23 10:14:38 I think there are many variants of CC if I'm not mistaken +May 23 10:15:05 urgh... I'm not that familiar with the merits of the various licenses +May 23 10:15:10 I don't mind GPL +May 23 10:15:29 but I'm not sure if GPL3 is right for our purposes... +May 23 10:15:39 Maybe we can do a dual MIT/GPL type license +May 23 10:15:40 there are various CC licenses, yes +May 23 10:15:45 sure +May 23 10:15:46 "take your pick" +May 23 10:16:05 as long as that works (from both camp +May 23 10:16:10 's perspectives) +May 23 10:16:14 damn enter key :-) +May 23 10:16:48 I'm flexible, so long as it's open source +May 23 10:16:51 yes, as far as I understand, many projects do this nowadays +May 23 10:16:57 makes both camps happy +May 23 10:16:58 and me too +May 23 10:16:59 cool. then that's fine. +May 23 10:17:09 because then I can use it at work (as opposed to pure GPL projects... :) ) +May 23 10:17:16 agreed +May 23 10:17:51 not that I think there will be any commercial derivatives of this work, but never say never, eh? +May 23 10:18:01 right +May 23 10:19:52 email sent +May 23 10:19:55 cool +May 23 10:20:23 DNS Error: Domain name not found +May 23 10:20:47 i feared that when I saw it was an edu... +May 23 10:20:52 well, I guess he'll be ok with us using it then +May 23 10:20:59 although it means if we use it, we can't license using MIT +May 23 10:21:17 I'll base my work off of it +May 23 10:21:19 his full name is Robert K. Ware +May 23 10:21:20 but do my own thing +May 23 10:21:43 i think that's the best way - then it's wholly our work +May 23 10:21:49 yeah +May 23 10:22:39 nice email. pity he won't see it. :-) +May 23 10:22:40 ok +May 23 10:22:53 lol +May 23 10:22:54 what is it, Saturday there? +May 23 10:22:58 yes +May 23 10:23:13 You'll like it. It was good. +May 23 10:23:16 :-) +May 23 10:23:24 ha +May 23 10:24:39 well, time for some DP! :-) I'm gonna dive into Wincent's ruby plugin to see how he did it. +May 23 10:24:49 super +May 23 10:24:51 thanks for the chat +May 23 10:24:55 same here +May 23 10:24:59 have a lovely night +May 23 10:25:03 it's been nice meeting you and beginning the work +May 23 10:25:11 likewise +May 23 10:25:32 let's stay in touch. My presence on github might be... low in the beginning. +May 23 10:25:43 (not much of a public contributor yet) +May 23 10:25:51 but my email contact should be fine +May 23 10:26:55 (I was having difficulty setting up my ssh for github, so that's another thing I'll look into today) +May 23 10:27:12 anyway, I'll let you go. +May 23 10:27:14 bye for now +May 23 10:28:30 take care +May 23 11:32:16 Are you there? +May 23 11:33:07 yep +May 23 11:33:17 oh good. Question for you +May 23 11:33:35 So in my original practice file, I put the answers *before* the question for one (kind of silly) reason +May 23 11:33:51 i noticed that... I kinda like after. What's your reasoning? +May 23 11:33:53 It was so I could skip from one question to the next by using "zj" (next fold) command +May 23 11:34:05 we can code our way around that... +May 23 11:34:22 I might like that +May 23 11:34:23 but +May 23 11:34:31 I think it makes more logical sense to seek the answer after the question +May 23 11:34:33 it is kind of nice to force the user to get used to navigating folds +May 23 11:34:39 that is true +May 23 11:34:40 rather than some arbitrary "vim kata" command +May 23 11:34:54 but yeah, the answer before the question is kind of weird +May 23 11:35:10 so here's another possibility +May 23 11:35:17 we could teach the search command / first +May 23 11:35:27 and mark our questions with a common something +May 23 11:35:30 like ~ +May 23 11:35:38 or > or whatever +May 23 11:35:45 then doing "n" for next question +May 23 11:35:56 this kind of makes sense to me +May 23 11:35:56 yeah, I was thinking along those lines... I think you'll find the common /^\w will be sufficient +May 23 11:36:07 since navigating search terms is much more common than navigating folds +May 23 11:36:12 agreed +May 23 11:36:31 we could number the steps in the kata... +May 23 11:36:37 so /^3 +May 23 11:36:52 Well, but then you can't press "n" for next +May 23 11:36:56 and /^\d +May 23 11:37:02 I see +May 23 11:37:08 I wish there were something easier +May 23 11:37:14 let me have a look at it +May 23 11:37:27 I'll get back to you later if I find a vimier way +May 23 11:37:28 :-) +May 23 11:37:31 since ^ and \d are not intuitive for first-time users (esp. if they've never used regexp) +May 23 11:37:37 ok +May 23 11:37:38 any other concerns? +May 23 11:37:47 No, that was it +May 23 11:37:52 I'm having fun with the first kata +May 23 11:37:56 you might be able to "story" your way around the /^\d +May 23 11:37:59 I'll check in what I have tonight before going to bed +May 23 11:38:01 sweet +May 23 11:38:05 I look forward to seeing it :-D +May 23 11:38:41 as for the stories (given my lack of bloginess), I'll leave the narratives up to you. :-) +May 23 11:38:56 heh, ok +May 23 11:39:03 but it is open to your review +May 23 11:39:19 cool +May 23 11:39:34 hey, how about wrapping the numbers in ()? +May 23 11:39:36 (1) +May 23 11:39:41 then search using /( +May 23 11:39:59 might work... depends on whether we have other () in the file +May 23 11:40:07 not start of line bound, I mean +May 23 11:40:24 is /^( that ugly? +May 23 11:40:35 well, we can introduce that later +May 23 11:40:42 but /( will get people started +May 23 11:41:11 I like line numbers, but we may have to create a line re-numberer if it gets crazy +May 23 11:41:15 heh... then /^< takes you to the squinting master and his answer ;-p +May 23 11:41:25 e.g. if we have to insert something between Q2 and Q3 and there are 40 questions... +May 23 11:41:30 i understand +May 23 11:41:31 hehe +May 23 11:41:37 that might not be too hard +May 23 11:41:41 k +May 23 11:41:50 i think i've done similar work for asciidoc numbered lists in the past +May 23 11:41:59 i'll dig through my old code and have a look +May 23 11:42:10 cool +May 23 11:42:15 thanks for the dialog +May 23 11:42:16 ttyl +May 23 11:42:25 same here. bye +May 23 12:26:31 ok, headed to bed. Files checked in. +May 23 12:27:06 sweet. have a good night. :-) +May 23 12:36:54 * canadaduane has quit (Quit: canadaduane) +May 23 12:44:09 * canadaduane has quit (Client Quit) diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/duane.kata --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/duane.kata Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,278 @@ +# Vim Practice +# by Duane Johnson + +Use 'j' to move down. + +Use 'k' to move up. + +Open the following fold: (move to the line and press 'l', or 'za' to toggle) +# Here is the fold {{{1 + 1. This folds over 4 lines + 2. Line 2 + 3. Line 3 + 4. Line 4 +#}}} + +#{{{ Answer: +> :set fdm=manual +> Vjzf +#}}} +Create a manual fold: + 1. Two-line fold + 2. Second line + +#{{{ Answer: +> zkzk +#}}} +Navigate to the previous fold, and then to the one before that. + +#{{{ Answer: +> mm +#}}} +Mark this line. + +#{{{ Answer: +> gg +#}}} +Move to the top of the file, then return to the mark. + +#{{{ Answer: +> G +#}}} +Move to the bottom of the file, then return to the mark. + +#{{{ Answer: +> H +#}}} +Move the cursor to the top of the window. + +#{{{ Answer: +> L +#}}} +Move the cursor to the bottom of the window. + +#{{{ Answer: +> M +#}}} +Move the cursor to the middle of the window. + +#{{{ Answer: +> C-O +#}}} +Go back to previous jump (i.e. bottom of the window, top of window, bottom of the file, etc.), then go forward to this. + +#{{{ Answer: +> qqI--lwwi--jq@q@@ +#}}} +Using a macro recording, prefix the first and third words of each +line with a double dash ("--"): + one two three four + five six seven eight + nine ten eleven twelve + +#{{{ Answer: +> "qp +#}}} +Display the contents of the register where you recorded the macro: + +#{{{ Answer: +> :s/-/_/g +> "qy +#}}} +Modify the above macro to use underscores instead of dashes, and +then read the macro back into the register. + +#{{{ Answer: +> V4j? +#}}} +Using the NERD Comment plugin, toggle comment these lines: + test { + this { + line + } + } + +#{{{ Answer: +> gv +#}}} +Restore the Visual Mode selection that you just used above. + +#{{{ Answer: +> wds' +#}}} +Using the 'surround' plugin, remove the single quotes. + 'surround' + +#{{{ Answer: +> wds) +#}}} +Remove parentheses: + (this is a parenthetical statement) + +#{{{ Answer: +> C-T +#}}} +Remove tags: + Word + +#{{{ Answer: +> f_xves'vEs] +#}}} +Using 'surround', remove the _value and replace with ['value']: + config_value + +#{{{ Answer: +> fxvf3s) +#}}} +Add parentheses around the x == 3: + if x == 3 { + } + +#{{{ Answer: +> VjS{ +#}}} +Surround the above two lines in curly braces. + +#{{{ Answer: +> :reg +#}}} +Show the contents of all registers. + +#{{{ Answer: +> "ayy +#}}} +Yank the following line into register 'a': + A line for register 'a'. + +#{{{ Answer: +> "Ayy +#}}} +Append the following line to register 'a': + Now register 'a' has two lines. + +#{{{ Answer: +> "ap +#}}} +Put the two lines in register 'a' below: + +#{{{ Answer: +> wwdw +#}}} +Delete the middle word: + Fabulous Text Editing + +#{{{ Answer: +> dd +#}}} +Delete this line: + You have a job to do. + +#{{{ Answer: +> dd +#}}} +And this one: + Now show how capable you are! + +#{{{ Answer: +> "2p +#}}} +Put the 'You have a job to do' line below, using the register for "two deletes ago": + + +#{{{ Answer: +> "-p +#}}} +Put the word 'Text' below, using the register for "small deletes": + + +#{{{ Answer: +> f|C +#}}} +Change the text from the | mark to the end of the line: + This is a sent|ence with stuff that needs to change. + +#{{{ Answer: +> C-T +#}}} +In Insert Mode, shift the following line right by 2 tab widths: + I feel too left + +#{{{ Answer: +> C-D +#}}} +In Insert Mode, shift the following line LEFT by 2 tab widths: + I feel too right + +#{{{ Answer: +> word C-O w word +#}}} +In Insert Mode, add a word at the | mark, then use a temporary Normal Mode command to skip a word, then insert another word: + Feel free to |insert a word. + +#{{{ Answer: +> C-U +#}}} +In Insert Mode, delete everything before the |: + If you add |words, please clean up after you're done + +#{{{ Answer: +> \sbear +#}}} +Replace the word 'tiger' with 'bear' in the following three lines: + The tiger lived in the jungle. + There were no other tigers like this tiger. + Tigers are dangerous. + +#{{{ Answer: +> :g/\#/d +#}}} +Highlight the following lines and delete those that contain hash symbols: + # Comment + This is text + # Another comment + Some more text + +#{{{ Answer: +> :v/\#/d +#}}} +Undo the changes, and remove lines that DO NOT contain hash symbols + +#{{{ Answer: +> V4j:g/^/m'< +#}}} +Reverse the following lines: + 1. First line + 2. Second line + 3. Third line + 4. Fourth line + +#{{{ Answer: +> mm +> (select 4 lines) +> :g//t'm +#}}} +Mark the following line, then select the above 4 lines and copy them to the mark: + Mark this line. + +#{{{ Answer: +> :hide e other.txt +#}}} +Edit another file in this window, but don't save the changes you've made to this file. + +#{{{ Answer: +> \f +#}}} +Open the NERD Explorer as a vertical split window. + +#{{{ Answer: +> s +#}}} +Choose a file in the Explorer and then open it in a new vertical split window. + +#{{{ Answer: +> :h +> CTRL-W_H +#}}} +Open a help window, then rearrange as a vertical split. + +# vim:foldmethod=marker diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/ftdetect/kata.vim --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/ftdetect/kata.vim Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,5 @@ +" Vim filetype plugin +" Language: VimKata +" Maintainer: Duane Johnson + +au BufNewFile,BufRead *.kata set filetype=kata diff -r 2ffdbbd7baa1 -r 79b5e20cd96a vim/notreallybundles/vimkata/ftplugin/kata.vim --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vim/notreallybundles/vimkata/ftplugin/kata.vim Wed May 26 12:34:24 2010 -0400 @@ -0,0 +1,164 @@ +" Vim filetype plugin +" Language: VimKata +" Maintainer: Duane Johnson + +" Only do this when not done yet for this buffer +if exists("b:did_ftplugin") + finish +endif +let b:did_ftplugin = 1 + +" preserve user's options +let s:save_cpo = &cpo +set cpo&vim + +setlocal commentstring=#%s foldmethod=marker +setlocal nospell nohlsearch + +function! s:Renumber() range + let b:k_count = 1 + exe a:firstline . ',' . a:lastline . "g/^(\\d\\+/s//\\='('.b:k_count/ | let b:k_count += 1" +endfunction + +function! s:GroupRenumber() + let group_boundary = '^\[.\{-}\]$' + " Locate the boundary of the group we're in + let firstline = search(group_boundary,'bnW') + 1 + let lastline = search(group_boundary, 'nW') - 1 + if lastline < 0 + let lastline = line('$') + endif + exe firstline . ',' . lastline 'call s:Renumber()' +endfunction + +function! s:NextQuestion() + call search("^(\\d\\+)") + normal j +endfunction + +function! s:NextQuestionWithPrep() + call s:NextQuestion() + call s:ExecutePreparation() +endfunction + +function! s:PrevQuestion() + call s:ThisQuestion() + normal k + call s:ThisInput() +endfunction + +function! s:ThisQuestion() + call search("^(\\d\\+)", "bc") +endfunction + +function! s:ThisInput() + call s:ThisQuestion() + normal j +endfunction + +function! s:ThisAnswer() + call s:ThisQuestion() + call search("^>") + normal ll +endfunction + +function! s:ThisPreparationLine() + call s:ThisQuestion() + let prepline = search("^<", "nW") + let nextqline = search("^(\\d\\+)", "nW") + + if nextqline < 0 + nextqline = search("$", "nW") + end + + if prepline > 0 && prepline < nextqline + return prepline + else + return -1 + endif +endfunction + +function! s:ExecuteAnswer() + call s:ThisAnswer() + exe "normal \"ay$" + call s:ThisInput() + exe "normal @a" +endfunction + +function! s:ExecutePreparation() + let prepline = s:ThisPreparationLine() + if prepline > 0 + exe prepline + "G" + normal ll + exe "normal \"ay$" + call s:ThisInput() + exe "normal @a" + else + call s:ThisInput() + end +endfunction + +" maps +if !hasmapto('Renumber') + nmap kr Renumber +endif +nnoremap