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 is nonexistent #206

Open
Cyrannosaurus opened this issue Nov 22, 2023 · 3 comments
Open

Documentation is nonexistent #206

Cyrannosaurus opened this issue Nov 22, 2023 · 3 comments

Comments

@Cyrannosaurus
Copy link

I want to use a Vec2f. I can't even find out what it is. People even need to guess what a Point is.

image
image

How are people figuring out how to use this package?

Am I meant to find a PR like this? 68c95df#diff-f47a387b26bd0238e77cc474a77f21a9de0bbd9634f17eaf6847e634ea4fbdee

And then learn where Vec is defined? And keep digging and digging and digging?

Is this meant to be a private club? Or do you make things to share them with other people? Cause docs are how you do that.

@rafaqz
Copy link
Contributor

rafaqz commented Nov 22, 2023

You might want to rethink your tone.

Overworked, dedicated developers made this for free and build amazing things with it like Makie.jl

And you can use it too, for free. But also with no warranty of any kind.

No one here owes you anything at all

So sure, make an issue "please improve docs". It needs better docs. We all know that. Its a matter of available time and hands on deck.

But consider wether your tone encourages or discourages people to work for free, for you.

@putianyi889
Copy link
Contributor

While op is indeed offensive, it makes a point. Although this package/org is maintained by volunteers for free, you do owe people one thing, that is the name of the package/org. The name appears at the top whenever people who need help search for a geometry package, so this package gains more attention (associated with both help and expectation) than it deserves, where expectation brings complaint like the op.

There will be more time and hands from the public if there is some working document. The functionality is great but not properly presented.

@rafaqz
Copy link
Contributor

rafaqz commented Jan 22, 2024

Feel free to write that document, or to present things better. Asking poeople with no time to do something they dont need is a hard sell. In contrast just doing it would be widely appreciated.

Although im afraid there are major simplifications on the way, so waiting for that may be best.

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

No branches or pull requests

3 participants