yardbird-users team mailing list archive

[Space Hobo <spacehobo@xxxxxxxxxxxxx>]

I just got a mail from a new yardbird user who had trouble with two
things.  The first was bug#448797, and the second was the lack of good
tutorial documentation.  Since we're starting to get more attention
thanks to Eric Florenzano's talk about unusual applications of Django, I
thought I'd send this list the part of my reply that dealt with the
documentation problem:

	Yeah, I've just dragged out some paper notes from last year, and
	I had decided to sit down and write out a tutorial that
	implemented a simple "karma" module like the one in Infobot:
	foo++ and foo-- will simply increment and decrement "karma"
	counters for a particular user or term, and urlconf patterns
	like "yardbird rules" or "ha ha twisted" can map to yardbird++
	and twisted-- respectively.  There's also a tradition of the
	phrases "botsnack" and "botsmack" equating to karma
	modifications for the bot itself.

	I figure this is a simple enough set of Models, possibly tying
	into the auth infrastructure (to detect when the karma
	modification is about a user), and it's the kind of app you can
	demonstrate from a few lines in each of the files a yardbird app
	uses.  Bonus points for then wiring up the appropriate django
	app parts to make a browsable karma interface on the Web.

	Anyway, all this can be done in layers-of-the-onion style with
	four tutorials:

		1: Setting up a yardbird bot with no apps save maybe the
		   contrib hooks for "RESET"
		2: Writing a bone-simple karma app and wiring it up to
		   the bot for #1
		3: Adding more complexity to the karma app
		4: Wiring up the karma app to traditional django web
		   behavior

I'm interested in hearing what the most important missing bits are, and
where the largest cognitive gaps can be found.  What was the biggest
frustration or AHA realization when you tried to wrestle yardbird to do
your bidding?  Does my hypothetical four-layer tutorial series sound
completely unhelpful?

-- 
Hey, how come nobody here in the future
has a time machine except me?