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!)
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!
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!)
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.
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.
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.
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?)