uxarray icon indicating copy to clipboard operation
uxarray copied to clipboard

DRAFT: User Guide & Documentation Improvements

Open philipc2 opened this issue 1 year ago • 3 comments

Closes #473

Overview

  • Introduces a the User Guide section to our documentation
  • Updated the front page with new descriptions and references to the Contributors Guide and User Guide

Updated Front Page

image

philipc2 avatar Sep 22 '23 14:09 philipc2

@aaronzedwick

Rajeev and I are working on populating a User Guide. I've assigned two sections to you if you'd be interested in helping out with them!

We can provide some guidance & a template as well!

philipc2 avatar Jan 09 '24 19:01 philipc2

@aaronzedwick

Rajeev and I are working on populating a User Guide. I've assigned two sections to you if you'd be interested in helping out with them!

We can provide some guidance & a template as well!

I would love to help! Templates and any guidance would be greatly appreciated! Also some insight into what is meant by distance operations? The great circle arcs?

aaronzedwick avatar Jan 10 '24 14:01 aaronzedwick

@aaronzedwick Rajeev and I are working on populating a User Guide. I've assigned two sections to you if you'd be interested in helping out with them! We can provide some guidance & a template as well!

I would love to help! Templates and any guidance would be greatly appreciated! Also some insight into what is meant by distance operations? The great circle arcs?

It would discuss the KDTree and BallTree data structures, including distance metrics. We could talk about the great circle arcs also (since haversine distance metric considers the lines as arcs)

philipc2 avatar Jan 10 '24 18:01 philipc2

Also some introduction for our constants will be helpful as well

constants intro is more of a subject for the developers guide

rajeeja avatar May 07 '24 20:05 rajeeja

Also some introduction for our constants will be helpful as well

constants intro is more of a subject for the developers guide

There are still some useful constants for the users.

For example, when the users are using our package, knowing what's the smallest value for the relative error tolerance is also important.

hongyuchen1030 avatar May 07 '24 20:05 hongyuchen1030

@hongyuchen1030

We can add a section once this is merged on the accuracy of our operators, including discussions on the expected error.

philipc2 avatar May 07 '24 20:05 philipc2