I do agree that there should be a "Getting Started" section, so that people can go to the site, find a list of relative documentation, and have a page explain a bit about how CS works, which demos do what, and how everything fits together. It should also list the community site, with explaination of what it is, it's purpose, and what they might find on it. Jinho's right... it's a pain to figure out where some of this information is sometimes. Now, I would edit the wiki for this, however, I think Jorrit needs to weigh in on this issue before that edit's made.

--Chris

On 6/17/06, Amir Taaki <[EMAIL PROTECTED]> wrote:
On Saturday 17 June 2006 04:11, Paul Chung wrote:
> Hello Everyone!
>
> As a newcomer to CS, one of the first things I noticed is that the way
> the website is right now makes it relatively hard to get started
> effectively. One of the first things I looked for was a Tutorial
> section, but there wasn't a dedicated Tutorials link on the side of
> the website and only after talking on IRC for a while did I realize
> that the tutorials were in the manual.

> While I really don't mean to be rude, I believe it would be in the
> best interest of all, especially newcomers, if the website were
> redesigned in a way similar to that of OGRE's site. There the wiki has
> very comprehensive instructions for installing the SDK, while more
> importantly, having a comprehensive set of getting started tutorials
> as well.

It is editable if you log in.

> Perhaps by making 'getting started' information more apparent, CS
> could lose some of its notoreity of having a "steep learning curve,"
> which would only help CS gain more users.
>
> Once again I hope this is just taken as constructive criticism- I
> myself being very impressed by the much more knowledgable folks who
> maintain the CS and its website. I just hope that somethings be
> changed to make CS better for all.
>
> -Jin. ho

CS *does* have a steep learning curve and IMO, the example applications and
the api docs are the best way at the moment to learn CS. Nonetheless you're
correct in saying the state of documentation is abysmal (and outdated).
Did you look around on the community site at all for some other snippets of
information?
http://community.crystalspace3d.org/tiki-view_articles.php
Also:
http://crystalspace3d.org/tikiwiki/tiki-index.php
http://crystalspace3d.org/tikiwiki/tiki-index.php?page=Documentation

Good luck, stick with it and hopefully you'll start being able to understand
CS's design philosophy soon.

>
> _______________________________________________
> Crystal-main mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/crystal-main
> Unsubscribe:
> mailto: [EMAIL PROTECTED]?subject=unsubscribe


_______________________________________________
Crystal-main mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/crystal-main
Unsubscribe: mailto: [EMAIL PROTECTED]?subject=unsubscribe



--
Christopher S. Case
Project Head
The Seventh Game: Precursors
http://games.g33xnexus.com/precursors
(716) 785 - 5553(Cellphone)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
"To err is human. To forgive, divine.
To fix mistakes, now that's an Engineer."
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
_______________________________________________
Crystal-main mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/crystal-main
Unsubscribe: mailto:[EMAIL PROTECTED]

Reply via email to