Re: [Yaml-core] linking to YAML Cookbook from yaml.org

[Clark C . E. <cc...@cl...>]

On Mon, Aug 05, 2002 at 07:48:33AM +0000, sh...@zi... wrote:
| I looked at Why's latest cookbook, and it's really a nice piece of work.
| Perhaps we could link to it from somewhere prominent on yaml.org.
| How about under the links for "Reference" and "Specification"?

I'd actually like to get yaml.org/<lang> and <lang>.yaml.org working
for each of the bindings.  I could really use some help here.
I just committed 3 directories, python, perl, and ruby under the
main yaml.org source code repository this would be great.
I'll setup a rsync with the repository as a cron job when I get
a spare moment...  till then I can manually sync as necessary.

Once this is done, I'll add a list of languages to the side bar
which link to each language's sub-page.  This page can have download
information, documentation, etc.

| 4) Consider putting the YAML and Ruby side by side in an HTML table.

I like the idea of having a separate cookbook for each language, as
most people won't be interested in more than one language; and if they
are, they can go look at the cookbook for their language instead.  In
particular, I was thinking these could be at a standard location, like
<lang>.yaml.org/cookbook.html

| 5) Add a multiple-language section that shows YAML converted to 
| Ruby, Python, and Perl.  I believe Brian will be adding Perl 
| examples to the TestingSuite soon.  We might be able to get some 
| links to the cookbook from pages like "Ruby for Perl programmers," etc.
| Seeing how the data structures map between languages should ease 
| the learning curve.

Ahh.  Now that's cool.  For N languages, this would make (N-1)! 
distinct documents; but all easly automatically updated.  Or 
perhaps one big one... although that could get to be a bit
tedious to read.  

| All of these are just ideas, of course.

And great ideas!

Clark