deeplearning4j-examples icon indicating copy to clipboard operation
deeplearning4j-examples copied to clipboard

Improve and expand README documentation for NDArray examples

Open NA-V10 opened this issue 1 month ago • 2 comments

This PR improves the documentation for the nd4j-ndarray-examples module.

✔ What was added

Expanded README with a clear explanation of what an NDArray is

Updated usage guide for INDArray operations

Added runnable code examples for:

NDArray creation

Arithmetic operations

Reshaping and broadcasting

Included instructions for running the examples with Maven

Added expected output to help beginners understand behavior

✔ Why this is useful

The previous README was minimal and did not explain:

What NDArray is

How to run the examples

What each operation does

This PR makes the module easier to understand for:

Beginners learning DL4J

Students exploring NDArray fundamentals

New contributors who want to verify expected behavior

✔ Notes

No code changes — documentation only.

Safe update, no breaking changes.

NA-V10 avatar Nov 18 '25 15:11 NA-V10

Try to clean this up and add back some more of the context that was there rather than just overriding something completely. I certainly don't mind better clarifying explanations of things though! Again thanks for the contributions!

agibsonccc avatar Nov 18 '25 22:11 agibsonccc

Thank you for the review!
I’ll clean up the README and restore the previous context that was removed, integrating it with the new clarifications.
I’ll push an updated version soon.

NA-V10 avatar Nov 19 '25 01:11 NA-V10