Better batch documentation

[ju-bezdek]

Code of Conduct

• I have read and agree to the Weaviate's Code of Conduct

What part of document/web-page on weaviate.io is affected?

What part of document/web-page on weaviate.io is affected?
https://weaviate.io/developers/weaviate/current/restful-api-references/batch.html

a) mention how references in single batch are handled. Currently it raises error (and @etiennedi) said that it's not a bug
(I've also created a feature request weaviate/weaviate#1951)

b) better explanation how batch works

• error handling (I didn't find solution proposed by @StefanBogdan here batch_create does not report on 'store is read-only' errors weaviate#1932 (comment) anywhere in the docs

c) add a link to Jupyter notebook with more examples and explanation https://github.com/semi-technologies/weaviate-examples/blob/main/getting-started-with-python-client-colab/Getting_Started_With_Weaviate_Python_Client.ipynb
... however even this notebook don't really tackles error handling in batch, and contains lot's of topics unrelated to batch processing, so maybe providing more complete examples to docs would be preferable

I'd strongly consider also merging the page with https://weaviate.io/developers/weaviate/current/tutorials/how-to-import-data.html

... I seems to be discusing the same concepts, there is strong overlap but, however both pages adds some more information to the topic...

Minimal effort solution would be also adding link to each other.

Additional comments?

No response

[etiennedi]

Thanks for the feedback, also looping in @sebawita for visibility of the above.