On Sun, 2006-06-18 at 20:45 +0200, Jorrit Tyberghein wrote: > I would love to have someone look more into this. I can't do this as > I'm too deeply into CS to still know what is easy for others and what > is not. People often tell me the CS site is not as easy as the OGRE > site but I don't know how to fix that. So if someone who does know can > do that fixing for us then I'm all for it. > > Greetings, >
This kind of work needs to be in conjunction with work on the core CS docs in SVN i.e. what the core docs need to say, what the docs and the website need to both say and where the website extends the contents of the core docs. Doing this will make the overall documentation far more coherent and useful for all who wish to use and work with CS. Regards Phil > On 6/18/06, Chris Case <[EMAIL PROTECTED]> wrote: > > 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 > > > > Crystal-main@lists.sourceforge.net > > > > > > https://lists.sourceforge.net/lists/listinfo/crystal-main > > > > Unsubscribe: > > > > mailto: > > [EMAIL PROTECTED] > > > > > > > > > _______________________________________________ > > > Crystal-main mailing list > > > Crystal-main@lists.sourceforge.net > > > https://lists.sourceforge.net/lists/listinfo/crystal-main > > > Unsubscribe: mailto: > > [EMAIL PROTECTED] > > > > > > > > > > > -- > > 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 > > Crystal-main@lists.sourceforge.net > > https://lists.sourceforge.net/lists/listinfo/crystal-main > > Unsubscribe: > > mailto:[EMAIL PROTECTED] > > > > > > > > _______________________________________________ Crystal-main mailing list Crystal-main@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/crystal-main Unsubscribe: mailto:[EMAIL PROTECTED]
