Documentation?

Started by defe, May 17, 2019, 02:26:59 PM

defe

I've seen mention of documentation for the non-open parts, but haven't been able to actually find any source for it.  I've got several mods planned, and have started really tearing apart the available source, but if external method calls and their arguments aren't enough to make clear what's going on, then I find it hard to keep finding the thread of what I need to figure out to do what I want.

Are the docs just not available yet?  If so, is there any idea when we might be able to expect them?  Or am I just missing the link somewhere?

Thanks!

- DJ DefE D

ai_enabled

Hello!

Unfortunately, the documentation is not yet ready.
We've tried to keep API reasonably simple and add comments to most of the methods. If you're using Visual Studio you could use Object Browser to explore CryoFall scripting API. IntelliSense for autocomplete should also display the comments.

Regards!

defe

It has been close to six months, has there been any progress on documentation?  It's easy enough to read the documentation in the parts where I have the source, but the closed parts of the API are a bit more black box than I can sort out for the types of things I'm looking to do. 

Is it perhaps possible to just get documentation for that part of the API if it's a matter of scheduling?  I really want to get busy on some heavy duty modding, but I just do not have enough information to do anything but simple mods at this point.

ai_enabled

defe, no progress was made in this regard as we're focusing on adding more features and content into the game.
Have you tried "Object Browser" in Visual Studio 2019 as was suggested before? We've provided comments to the most methods in API and they should be browsable from there.

Regards!

defe

I have looked at the DLLs and such with the object browser, but comments on compiled code does not show there.  It gives me an idea of the shape of it all, but not the function.

ai_enabled

We're shipping accompanying XML files for .NET assemblies (DLLs) with VS-formatted XML documentation.
If you load the csproj in VS you can inspect the project references and open Objects Browser for any of the API assemblies. Here is a screenshot of how it looks (https://atomictorch.com/Files/Images/CryoFall_VS_ObjectBrowser.png).

Regards!

defe

Ah, great, I'll give that a try.

Thanks!

mav

#7
I am getting the error message: "Value does not fall within expected range."

Where am I messing up? :)


Edit:
I started with a fresh slate; created a new CryoFall Mod Project and added a reference to CoreMod.

There I can use the view in object browser option.

If I open a solution file in Core.cpk or Editor.mpk directly, trying to view the documentation, it's giving me the error message.