Mailing List Archive

Nice job ! What an easy and friendly tutorial for the beginner. If
Akopia would write in this fashion a detailed documentation/tutorial of
all its fancier features, it would certainly have something to sell to the
common (wo)men.

As you already have a page-wise display of your good stuff, why
not sell the documentation per page ? A dime for the easy
stuff, a dollar for a bit more, and of course for Mike Heins' tips
and tricks you will have to break your bank, and forget about the
usertags, you need to get a loan to buy them...but...it's worth
it. (Just kidding - just being happy to see some nice work).

I have an idea.

May be you demonstrate the fancier stuff exactly by letting the
user build a fancy documentation catalog, combining content management
features of a technical textbook-style documentation with a shopping cart
selling the documentation's text pages per page/chapter/tag/code snippet.

Imagine a szenario where no user could get the source code, unless he
had gone through the tutorial of making a fancy documentation catalog.
That would solve three problems in one strike.

First the user would really have to build one catalog from scratch
guided by the tutorial for building a "documentation catalog".

Second the user would really have to read the documentation, because
he needs to type the text once to build the catalog pages during the
tutorial's session. No more users who haven't read the docs. That should
be something Mike Heins would love, right ? 8-)

Third, Akopia could finally sell something aside from the consultancies.
How about incorporating the project of building a documentation catalog
into an online/in-class training program ? Could be very effective and
you could offer much more detailed information, as people would pay
for it.

I think that would be a nice way of honoring the work, which went into
writing the IC code and documentation and an effective way of teaching
people its features, scope and flexibility.

The source code would stay open, the documentation more than free (once
the user has learned how to build the documentation catalog, he also knows
how to add his own future changes of the docs to that catalog), without
being "priceless", because it isn't. 8-)

Cheers,
Birgitt

See a problem with the new tutorial on PDF format.

All the [. brackets in the code examples are listed as 91;

great to have it all in PDF, but deciphering the code examples may be tricky
for a beginner ;)

Russ Smith
MediaServices Network, Inc

-----Original Message-----
From: interchange-users-admin@lists.akopia.com
[mailto:interchange-users-admin@lists.akopia.com]On Behalf Of BF
Sent: Friday, January 12, 2001 11:40 PM
To: interchange-users@lists.akopia.com
Subject: [ic] IC Catalog-Building Tutorial available



Nice job ! What an easy and friendly tutorial for the beginner. If
Akopia would write in this fashion a detailed documentation/tutorial of
all its fancier features, it would certainly have something to sell to the
common (wo)men.

As you already have a page-wise display of your good stuff, why
not sell the documentation per page ? A dime for the easy
stuff, a dollar for a bit more, and of course for Mike Heins' tips
and tricks you will have to break your bank, and forget about the
usertags, you need to get a loan to buy them...but...it's worth
it. (Just kidding - just being happy to see some nice work).

I have an idea.

May be you demonstrate the fancier stuff exactly by letting the
user build a fancy documentation catalog, combining content management
features of a technical textbook-style documentation with a shopping cart
selling the documentation's text pages per page/chapter/tag/code snippet.

Imagine a szenario where no user could get the source code, unless he
had gone through the tutorial of making a fancy documentation catalog.
That would solve three problems in one strike.

First the user would really have to build one catalog from scratch
guided by the tutorial for building a "documentation catalog".

Second the user would really have to read the documentation, because
he needs to type the text once to build the catalog pages during the
tutorial's session. No more users who haven't read the docs. That should
be something Mike Heins would love, right ? 8-)

Third, Akopia could finally sell something aside from the consultancies.
How about incorporating the project of building a documentation catalog
into an online/in-class training program ? Could be very effective and
you could offer much more detailed information, as people would pay
for it.

I think that would be a nice way of honoring the work, which went into
writing the IC code and documentation and an effective way of teaching
people its features, scope and flexibility.

The source code would stay open, the documentation more than free (once
the user has learned how to build the documentation catalog, he also knows
how to add his own future changes of the docs to that catalog), without
being "priceless", because it isn't. 8-)

Cheers,
Birgitt


_______________________________________________
Interchange-users mailing list
Interchange-users@lists.akopia.com
http://lists.akopia.com/mailman/listinfo/interchange-users

wow, that sounds really cool, ty everyone who helped
Troy

----- Original Message -----
From: "Jon Jensen" <jon@akopia.com>
To: <interchange-users@minivend.akopia.com>
Sent: Friday, 12 January, 2001 12:19
Subject: [ic] IC Catalog-Building Tutorial available


> We just finished a new tutorial that will familiarize you with many of the
> basic concepts of Interchange catalogs by leading you through the process
> of building a catalog from the ground up, all by hand. You'll create every
> directory and file yourself, and understand what each part does. When
> you're done, you'll have a very basic but working catalog, but more
> importantly, we hope you'll have learned a lot about Interchange.
>
> You can download it here in PDF format:
>
> http://developer.akopia.com/doc/iccattut.pdf
>
> Or read it on the developer site:
>
> http://developer.akopia.com/cgi-bin/ic/dev/index.html
>
> Sonny Cook came up with the idea for this and wrote the first version. We
> hope to expand the "Enhancing the Catalog" chapter with sections
> contributed by the community, so we'd love to see you develop a new
> feature, write it up in tutorial style, and send it to us.
>
> Jon
>
>
> _______________________________________________
> Interchange-users mailing list
> Interchange-users@lists.akopia.com
> http://lists.akopia.com/mailman/listinfo/interchange-users
>


---
Outgoing mail is certified Virus Free.
Checked by AVG anti-virus system (http://www.grisoft.com).
Version: 6.0.226 / Virus Database: 108 - Release Date: 1/5/2001