Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation #49

Open
Nolram12345 opened this issue Jun 12, 2021 · 5 comments
Open

Documentation #49

Nolram12345 opened this issue Jun 12, 2021 · 5 comments
Assignees
Labels
enhancement New feature or request

Comments

@Nolram12345
Copy link

This package, while it seems very capable, has absolutely no documentation from what I have found. I would really like to use it, but I have no idea how. ANY examples or documentation would be needed greatly.

@Whinarn
Copy link
Owner

Whinarn commented Jun 12, 2021

You are right in that there is currently no usable documentation for this package as of now.
Originally it was intended for programmers and had a very simple API that didn't need much of an explanation. But with the introduction of the LOD Generator Helper component, there is a greater need for documentation.

If you are a programmer then the API is pretty well documented with XML-comments with these small examples enough to get you started, but if not, then you are out of luck.
I have put it on hold since it seems like most people have been able to use it anyways, but I'll see if I can make time to add some basic documentation to the repository wiki or something. While I'm not very interested in developing further features, it feels like I should at least add some basic documentation before I can consider this project "completed".

@Nolram12345
Copy link
Author

Ah, thanks for the clarification. Sad that you have more or less shelved this now - there would have probably been some interesting places to go with this, like dynamic GPU mesh decimation. But if you could provide any more documentation that would be very appreciated.

@Whinarn
Copy link
Owner

Whinarn commented Jun 14, 2021

Absolutely, there are plenty of features that would improve this package. Unfortunately however I don't have the time or interest to maintain it more than fixing bugs (and potentially documentation). Since I am not a user of the package myself it's hard to motivate why I should spend time working on it, and it's also more difficult to be proactive with it. Obviously I'm a supporter of open source, but I'd rather work on something that is better aligned with my interests and expertise.

I hope that someone someday can take over maintaining this package, or create another free and open source alternative for everyone out there not looking to pay $100 for their hobby or indie game.

But we'll see what happens. I might decide to pick this up again if I get back into game development.

I cannot promise any documentation this or next week however. Just a heads up.

@Nolram12345
Copy link
Author

Ah, that is absolutely understandable, hope someone else can be found...
Also, I am a bit unsure whether you fully understood what I meant with lacking documentation - it would also be great to have more documentation on the actual usage of the API as well as the LOD Generator component.

@Whinarn
Copy link
Owner

Whinarn commented Aug 16, 2021

Hi @Nolram12345 ,

I just wanted to let you know that I have worked a bit to document the LOD Generator Helper component here: https://github.com/Whinarn/UnityMeshSimplifier/wiki/LOD-Generator-Helper-component

Please have a look if you have the time.

I will leave this issue open since there are much more things that can be documented.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants