GeometryTypes.jl icon indicating copy to clipboard operation
GeometryTypes.jl copied to clipboard

Documentation improvements

Open asinghvi17 opened this issue 5 years ago • 4 comments

For newbies, it would be nice to improve the documentation a little:

  • Clarify what Hyper means (just signifying generalizability to $n$-dimensions)
  • Simpler examples with convenience functions (Rect, Sphere, Circle, ...)
  • Explicitly clarify what f0 means

asinghvi17 avatar Feb 10 '20 15:02 asinghvi17

I agree a lot. I have been here a few times and looked through the documentation to see if things like triangles are implemented and I see nothing so I turn away. It wasn't until recently I actually dove into the source code and saw the over 100 exports and was truly astounded that so little is documented in the documentation. It turns out this code is extremely useful for me but I just never knew it was usable. Now, too, I have to sift through source code to find the functionality I want instead of just seeing it in the docs.

mileslucas avatar Mar 09 '20 07:03 mileslucas

I can't even find out what a Vec2f is

Cyrannosaurus avatar Nov 22 '23 20:11 Cyrannosaurus

The documentation is laughable. What is a point? Docs don't know. A vector? Well, I guess it exists, but oh, you want to know how to go about using it? No way buddy, figure it out yourself. image

Cyrannosaurus avatar Nov 22 '23 20:11 Cyrannosaurus

I don't think GeometryTypes.jl is maintained anymore. Take a look at Meshes.jl if you are doing geometric processing or GeometryBasics.jl if you are simply trying to visualize basic geometries.

juliohm avatar Nov 22 '23 20:11 juliohm