Newton API Documentation

A place to discuss everything related to Newton Dynamics.

Moderators: Sascha Willems, walaber

Newton API Documentation

Postby aqnuep » Sun Oct 18, 2009 1:27 pm

Hi,

I know this is an all-time-upcoming topic, but I would really like to emphasize that there is a great need at least for some very rough documentation of Newton.
As I see most of the general discussion forum's topics are all about misunderstanding of functions because of lack of documentation.

I would be in to make the documentation if I would receive the required information.
What is your opinion guys?
aqnuep
 
Posts: 97
Joined: Sat Dec 22, 2007 4:14 pm

Re: Newton API Documentation

Postby samisaham » Sun Oct 18, 2009 1:50 pm

I think that would be quite helpful, even just putting more detail/description into the wiki's listed api function would help greatly.
samisaham
 
Posts: 15
Joined: Mon Mar 24, 2008 11:59 am

Re: Newton API Documentation

Postby Stucuk » Sun Oct 18, 2009 3:59 pm

IMO it would be better if you expanded the Wiki rather than made offline documentation.
User avatar
Stucuk
 
Posts: 801
Joined: Sat Mar 12, 2005 3:54 pm
Location: Scotland

Re: Newton API Documentation

Postby aqnuep » Mon Oct 19, 2009 5:49 am

I totally agree, the Wiki is the perfect place for this.

My problem is that I also don't know most of the Newton API's functionality, just those that I already used and it would be quite hard to get all the needed information.

I would encourage all you Newton experts to participate in making the Wiki better.

I can start making Wiki pages, let say two or three per week, but my main problem is that I lack some of the needed knowledge and I don't want to mislead people by putting invalid information on the Wiki.
aqnuep
 
Posts: 97
Joined: Sat Dec 22, 2007 4:14 pm

Re: Newton API Documentation

Postby JernejL » Mon Oct 19, 2009 8:44 am

It shouldn't be a problem, i made "blank" wiki pages with just function definition for most newton functions, you can just add descriptions, parameter meaning, purpose.. i did a few functions already ( NewtonWorldConvexCast ), and i'm sure we can collaborate on forum with Julio and clear up any unknown stuff about functions for the wiki, the undocumented functions are categorized:

http://newtondynamics.com/wiki/index.ph ... escription
Help improving the Newton Game Dynamics WIKI
User avatar
JernejL
 
Posts: 1587
Joined: Mon Dec 06, 2004 2:00 pm
Location: Slovenia

Re: Newton API Documentation

Postby aqnuep » Mon Oct 19, 2009 11:53 am

Btw is there an online documentation for the legacy API functions? I mean those which were already in Newton 1.53.
Also is there some documentation about the legacy API functions that changed since 1.53?
I'm asking this because I can find no resource even on those.
Maybe I'm stupid and there is something that I haven't observed.
aqnuep
 
Posts: 97
Joined: Sat Dec 22, 2007 4:14 pm

Re: Newton API Documentation

Postby Stucuk » Mon Oct 19, 2009 1:58 pm

1.53 had offline documentation.
User avatar
Stucuk
 
Posts: 801
Joined: Sat Mar 12, 2005 3:54 pm
Location: Scotland

Re: Newton API Documentation

Postby Julio Jerez » Mon Oct 19, 2009 2:11 pm

aqnuep wrote:Hi,

I know this is an all-time-upcoming topic, but I would really like to emphasize that there is a great need at least for some very rough documentation of Newton.
As I see most of the general discussion forum's topics are all about misunderstanding of functions because of lack of documentation.

I would be in to make the documentation if I would receive the required information.
What is your opinion guys?

Actually that's a good idea,
send me a PM
Julio Jerez
Moderator
Moderator
 
Posts: 12426
Joined: Sun Sep 14, 2003 2:18 pm
Location: Los Angeles

Re: Newton API Documentation

Postby JernejL » Mon Oct 19, 2009 2:12 pm

aqnuep wrote:Btw is there an online documentation for the legacy API functions? I mean those which were already in Newton 1.53.
Also is there some documentation about the legacy API functions that changed since 1.53?
I'm asking this because I can find no resource even on those.
Maybe I'm stupid and there is something that I haven't observed.


ALL the 1.53 offline documentation was imported into wiki, it is all there.
Help improving the Newton Game Dynamics WIKI
User avatar
JernejL
 
Posts: 1587
Joined: Mon Dec 06, 2004 2:00 pm
Location: Slovenia

Re: Newton API Documentation

Postby aqnuep » Tue Oct 20, 2009 4:33 am

Sorry, I know that there was an offline documentation unfortunately I didn't find it nowadays, but okay, unfortunately I'm not totally competent about these stuff. Anyway I'm into making a good documentation and I'll help as much as possible.
aqnuep
 
Posts: 97
Joined: Sat Dec 22, 2007 4:14 pm

Re: Newton API Documentation

Postby JernejL » Tue Oct 20, 2009 4:47 am

aqnuep wrote:Sorry, I know that there was an offline documentation unfortunately I didn't find it nowadays, but okay, unfortunately I'm not totally competent about these stuff. Anyway I'm into making a good documentation and I'll help as much as possible.


There was only for newton 1.53, newton 2.x has everything that there is up to now on the wiki.
Help improving the Newton Game Dynamics WIKI
User avatar
JernejL
 
Posts: 1587
Joined: Mon Dec 06, 2004 2:00 pm
Location: Slovenia

Re: Newton API Documentation

Postby Carli » Tue Oct 20, 2009 10:32 am

is there a chance to grab the wiki contents to a .chm?
Carli
 
Posts: 245
Joined: Fri Oct 02, 2009 5:28 am

Re: Newton API Documentation

Postby JernejL » Tue Oct 20, 2009 2:48 pm

Carli wrote:is there a chance to grab the wiki contents to a .chm?


i'm not sure about export, but it is great to have it online as you can use google search on it directly.
Help improving the Newton Game Dynamics WIKI
User avatar
JernejL
 
Posts: 1587
Joined: Mon Dec 06, 2004 2:00 pm
Location: Slovenia


Return to General Discussion

Who is online

Users browsing this forum: No registered users and 1 guest

cron