# A suggestion to make the documentation more efficient

**URL:** <https://forum.weaviate.io/t/a-suggestion-to-make-the-documentation-more-efficient/2394>\
**Category:** General\
**Created:** [May 21, 2024, 6:22am UTC](https://forum.weaviate.io/t/a-suggestion-to-make-the-documentation-more-efficient/2394 "2024-05-21T06:22:02Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![rjalex](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.weaviate.io/rjalex/32/807_2.png) [@rjalex](https://forum.weaviate.io/u/rjalex)\
**Post date:** [May 21, 2024, 6:22am UTC](https://forum.weaviate.io/t/a-suggestion-to-make-the-documentation-more-efficient/2394/1 "2024-05-21T06:22:02Z")

</div>

I really love weaviate and admire the huge effort to build a product that I find unbelievably useful but as a beginner sometimes I am stuck because the documentation is too fragmented.

What I mean is that for example if you read a tutorial on using cross references you get a good example on how to use it:

```auto
questions = client.collections.get("JeopardyQuestion")

questions.data.reference_add(
    from_uuid=question_obj_id,
    from_property="hasCategory",
    to=category_obj_id
)

```

but this would be immensely clearer if you could also see the corresponding collection definition of both JeopardyQuestion and the JeopardyCategory collections.

More generally the way you setup your server (in the case of self-hosted), the way you declare your collections and the way you query or otherwise use them are all related.

Wouldn’t it be possible in the example of the cross-reference query to also have a link to corresponding collection definitions? And when necessary to corresponding server setups (such as including a given module)?

My 2 beginner’s cents 🙂

The other thing I sometimes struggle is understanding where some classes/function come from. See for example this top of a program I wrote to understand cross-references:

```auto
import weaviate
from weaviate.util import generate_uuid5
from weaviate.exceptions import WeaviateBaseError
from weaviate.classes.data import DataReference
import weaviate.classes.config as wvcc
from weaviate.classes.query import QueryReference

```

what would be the best way to know which class/function is “hidden” where?

You all take care.

---

<div class="post-metadata">

**Author:** ![DudaNogueira](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.weaviate.io/dudanogueira/32/7846_2.png) [@DudaNogueira](https://forum.weaviate.io/u/DudaNogueira)\
**Post date:** [May 21, 2024, 2:26pm UTC](https://forum.weaviate.io/t/a-suggestion-to-make-the-documentation-more-efficient/2394/2 "2024-05-21T14:26:31Z")

</div>

hi @rjalex !! Thanks again for being an amazing community user!

I will make sure to pass this along to our doc team!

Thanks!