Website for Gorgonia

[chewxy]

Gorgonia needs a website, I've been told. There are many features people don't know about, and they should be documented. Here's a rough framework in mind

• Basic Section
  • Fundamentals: Computation Graphs
  • Fundamentals: Tensors
  • Fundamentals: Backpropagation and How It Relates to Differentiation
  • Fundamentals: Stochastic Gradient Descent (VanillaSGD and RMSProp)
  • Examples
    • Logistic Regression
    • Stacked Autoencoder
    • RNNs
    • LSTM
• Advanced section
  • Different execution modes (LispMachine vs TapeMachine)
  • Optimizing the computation graph
  • Using MKL/CUDA
  • Exploring the various SGD solvers provided in Gorgonia: ADAM, AdaGrad, etc
  • Extending Gorgonia
    • New Ops
    • New Solvers
  • Debugging your neural network
• Behind the Scenes
  • The design of Tensors
  • Design Decisions and Rationales

[kabaka0]

Definitely worth doing once 1.0 is achieved. Happy to pitch in.

[damienstanton]

I'd be glad to pitch in on this as well. I've had great success serving a static site with Caddy. Quick and easy.

[chewxy]

I was thinking Github pages.

@kabaka0 watch the coveralls profile. Once it hits 85%+ - 90% I'll consider it 1.0. The majority of the tests to be done are on the package gorgonia. I'll also have to write tests for the transpose and stack methods in package tensor

[damienstanton]

@chewxy @kabaka0 I'm thinking of doing this using Hugo, for a quick and easy static site that can be put on GH pages using this theme. What do you think?

[chewxy]

I've recently moved my blog over to Hugo too.. I think that's a fantastic idea

[damienstanton]

@chewxy what are your thoughts on this theme? We are exploring using at work and it seems like it is pleasant, easy to read through and bonus of being multilingual.

[chewxy]

very nice code walkthru like right panel. I like it. I'm not particularly fussy about this tbh

[damienstanton]

@chewxy I finally got around to starting this. To get the flavor I've simply ported over the readme, and the Hugo theme picked up the code examples nicely. It is also searchable, which makes for a good start.

Live demo here
Source here

[chewxy]

I especially like the sample code at the side. Very nice

[chewxy]

Added you to the repo https://github.com/Gorgonia/gorgonia.org

You should have commit and admin rights. Tell me if you don't

[chewxy]

hey @damienstanton , out of curiosity could you check if you have admin rights to the repo above

[damienstanton]

I do, thanks 👍

[chewxy]

Ah great. Can you generate docs in hugo so that the metadata can be added such that gorgonia/gorgonia#117 is possible?

[damienstanton]

Will do. I should be able to get this done over the weekend, if not earlier.

[ouwe-knutselaar]

I've been looking at the website but it is still very hard to understand as a beginner what you are building.
After following the tutorials, I'm not able to use Gorgonia. The level is still too high.
There should be a more detailed explanation about what is build and why certain functions/types/decisions are made.