Merge pull request #22 from SciML/sb/index_readme

docs: update README and index.md

Author: ChrisRackauckas

README.md

@@ -7,4 +7,8 @@
 [![ColPrac: Contributor's Guide on Collaborative Practices for Community Packages](https://img.shields.io/badge/ColPrac-Contributor%27s%20Guide-blueviolet)](https://github.com/SciML/ColPrac)
 [![Aqua](https://raw.githubusercontent.com/JuliaTesting/Aqua.jl/master/badge.svg)](https://github.com/JuliaTesting/Aqua.jl)
 
-## Build UDEs with ModelingToolkit
+ModelingToolkitNeuralNets.jl is a package to create neural network blocks defined similar to MTKStandardLibrary components, to use them for solving Universal Differential Equations. It can be plugged to any part of the equations in an ODESystem using `RealInputArray` and `RealOutputArray` components which gives a lot of flexibility to add the missing physics only to a part of the model.
+
+## Tutorials and Documentation
+
+For information on using the package, [see the stable documentation](https://docs.sciml.ai/ModelingToolkitNeuralNets/stable/). Use the [in-development documentation](https://docs.sciml.ai/ModelingToolkitNeuralNets/dev/) for the version of the documentation, which contains the unreleased features.

docs/make.jl

@@ -29,5 +29,6 @@ makedocs(;
 
 deploydocs(;
     repo = "github.com/SciML/ModelingToolkitNeuralNets.jl",
-    devbranch = "main"
+    devbranch = "main",
+    push_preview = true
 )

docs/src/friction.md

@@ -152,6 +152,7 @@ res_prob = remake(prob, p = res_p)
 res_sol = solve(res_prob, Rodas4(), saveat = sol_ref.t)
 @test first.(sol_ref.u)≈first.(res_sol.u) rtol=1e-3 #hide
 @test friction.(first.(sol_ref.u))≈(Fu .- first.(res_sol(res_sol.t, Val{1}).u)) rtol=1e-1 #hide
+nothing #hide
 ```
 
 Also, it would be interesting to check the simulation before the training to get an idea of the starting point of the network.

docs/src/index.md

@@ -2,17 +2,35 @@
 CurrentModule = ModelingToolkitNeuralNets
 ```
 
-# ModelingToolkitNeuralNets
+# ModelingToolkitNeuralNets.jl
 
-Documentation for [ModelingToolkitNeuralNets](https://github.com/SciML/ModelingToolkitNeuralNets.jl).
+ModelingToolkitNeuralNets.jl is a package to create neural network components defined similar to MTKStandardLibrary components, to use them for solving Universal Differential Equations. It can be plugged to any part of the equations in an ODESystem using `RealInputArray` and `RealOutputArray` components which gives a lot of flexibility to add missing physics only to the relevant parts of the model.
 
-```@index
-```
+## Installation
+
+To install ModelingToolkitNeuralNets.jl, use the Julia package manager:
 
-```@autodocs
-Modules = [ModelingToolkitNeuralNets]
+```julia
+using Pkg
+Pkg.add("ModelingToolkitNeuralNets")
 ```
 
+## Contributing
+
+  - Please refer to the
+    [SciML ColPrac: Contributor's Guide on Collaborative Practices for Community Packages](https://github.com/SciML/ColPrac/blob/master/README.md)
+    for guidance on PRs, issues, and other matters relating to contributing to SciML.
+
+  - See the [SciML Style Guide](https://github.com/SciML/SciMLStyle) for common coding practices and other style decisions.
+  - There are a few community forums:
+    
+      + The #diffeq-bridged and #sciml-bridged channels in the
+        [Julia Slack](https://julialang.org/slack/)
+      + The #diffeq-bridged and #sciml-bridged channels in the
+        [Julia Zulip](https://julialang.zulipchat.com/#narrow/stream/279055-sciml-bridged)
+      + On the [Julia Discourse forums](https://discourse.julialang.org)
+      + See also [SciML Community page](https://sciml.ai/community/)
+
 ## Reproducibility
 
 ```@raw html