|
Post by Alyce on Oct 24, 2007 7:54:07 GMT -5
|
|
|
Post by Alyce on Oct 25, 2007 14:31:17 GMT -5
I've added a few building blocks and I see that Mike has added one as well. Ideally, we'd have explanations and small, commented, runable snippets for each command, statement and method.
If you add to the building blocks, remember to keep it simple. You can include the documentation from the helpfile. You can add a short explanation of your own, if you'd like. Be sure to include a bit of code to illustrate it.
Keep it clear. Keep it short. (Remember, people like ME need to understand it!)
|
|
|
Post by turbov21 on Oct 25, 2007 15:09:27 GMT -5
Is the wiki locked down? I can't find the edit button on any of the pages.
|
|
|
Post by Alyce on Oct 25, 2007 15:20:20 GMT -5
Is the wiki locked down? I can't find the edit button on any of the pages. You must be logged in to your wikispaces account. If you can't see an edit tab, you need to log in. Jerry just changed the permissions, so only members can edit. I'll send you an invitation, but you could also click the "join" link.
|
|
|
Post by turbov21 on Oct 25, 2007 15:25:31 GMT -5
Thanks!
|
|
|
Post by Alyce on Oct 26, 2007 5:51:44 GMT -5
Thanks, Andrew and Mike, for adding to the Building Blocks. I've added the helpfile docs for the commands you demonstrated. Wikis are dynamic repositories, so we can continue to tweak the content forever. I know I'll be adding more and USING the info frequently. Thanks, all!
|
|
|
Post by Alyce on Oct 27, 2007 6:28:44 GMT -5
Fantastic! Mike, Andrew and Carl have been helping the the Building Blocks. I hope to get the entire RB command set documented with explanations and sample code eventually. We'll get there if we keep adding content and tweaking existing content.
This exemplifies the best features of a Wiki -- community involvement and information sharing. We rock!
(Much of this will also be applicable to LB5, so we've all got a headstart!)
|
|
|
Post by Alyce on Nov 4, 2007 12:29:15 GMT -5
Janet has made the Building Blocks SO MUCH EASIER! Thank you, Janet for the incredible tutorials on CSS styles.
The Building Blocks for CSSID and CSSCLASS only needed to give the bare minimum for their use and a link to your fantastic article! Woohoo!
We're a small community as yet, but with lots of contributions!
I'm learning this stuff thanks to you guys!
|
|
|
Post by Alyce on Nov 4, 2007 12:30:37 GMT -5
If you see an error in the Building Blocks, feel free to fix it. That's the way a Wiki functions. Don't worry that you'll mess things up. We can always revert a page to a previous version, so there's no such thing as a fatal error.
|
|
|
Post by Janet on Nov 4, 2007 13:30:58 GMT -5
This is becoming an awesome (in the best sense of the word) project. All you guys rock, especially Alyce! ;D
|
|
|
Post by mikeukmid on Nov 4, 2007 14:50:19 GMT -5
Thank you for your extreme effort Alyce and Janet. Yes I did make two very small contributions, but each time I had worked through a statement/command/method, I noticed Alyce had already written up an entry - one step ahead as always. RB has really come out of the woodwork now, some fantastic applications should soon start to appear. Mike
|
|
|
Post by Alyce on Nov 8, 2007 6:53:21 GMT -5
A couple of you nice people have sent me private messages to alert me to typos and stuff like that.
It's a WIKI! You can fix them must faster than it takes to tell me about my boo-boos. Trust me, I won't be at all insulted. The old eyes (and fingers) aren't what they used to be and typing a colon instead of quotation marks happens more often than I'd like.
You simply cannot mess up if you edit a page. It can ALWAYS be reverted to a past version.
Carl has been tweaking my Building Blocks -- fixing errors, adding more info. I'm honored that he's taken the time to read them and DELIGHTED to see him fixing things.
Come on, guys, jump in and don't worry about hurting feelings. We ALL make errors and everything we write can be improved. Consider it a WIP (work in progress) forever. It will NEVER be done. It can ALWAYS be improved.
It's fantastic to see so much action on the wiki. I'll bet Jerry is smiling right now.
|
|
|
Post by Jerry Muelver on Nov 8, 2007 7:17:22 GMT -5
;D
|
|
|
Post by Alyce on Dec 1, 2007 10:18:17 GMT -5
I hope to get back to the Building Blocks this week. I started on Select Case, but hit a bug. Carl has explained that, so I'll carry on.
Remember, Building Blocks as I see them, are meant to be very brief articles with tiny bits of well-commented, runable code.
Fuller demos are also very welcome on the wiki. List them on the code page.
I want to avoid large demos on the Building Blocks, wherever possible. I've seen this happen many times. People ask how to do something and are referred to a program that does what they want, but it is large and complicated and the person asking the question cannot extract just those parts that he needs.
Larger demos are fantastic and I learn A LOT from them. Building Blocks are more of a reference than a collection of sample programs. For instance, I looked at Carl's sample RunWiki code and got lost right away. Not the best way to get one's feet wet in SQL. Now that I know more about SQL, I'll be studying that RunWiki code more carefully.
BTW, if you haven't noticed, Carl has added tutorials to the helpfile. Look at the right side of the page. General, graphics, tables and SQL tutorials are already in place and it looks like XML parsing and creating objects are coming.
My interpretation of documentation and learning materials:
Helpfile: simple reference document where you can look up command syntax and usage.
Tutorial: set of progressive lessons that show how to do something, building each lesson on the knowledge learned in the previous one.
Demos: well-commented programs that demonstrate a full range of commands and methods associated with a particular type of programming.
Building Blocks: enhancements to the helpfile that reiterate the syntax and show it in action in tiny bits of code, easily extractable and applicable to the reader's own programs.
Now Jerry can come behind and disabuse me of my incorrect notions! Comments welcome!
(And all of these things go on the wiki... wiki is the answer. What was the question again?)
|
|
|
Post by mikeukmid on Dec 1, 2007 11:38:09 GMT -5
Alyce, excuse my 'blindness' but I can't find the tutorials you refer to. Can you point me in the right direction please?
TIA
Mike.
|
|