Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added _assets/friends/amd-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
28 changes: 24 additions & 4 deletions _layout/navbar.html
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,15 @@
<li class="nav-item">
<a class="nav-link" href="https://fluxml.ai/Flux.jl/dev/ecosystem/">Ecosystem</a>
</li>
<li class="nav-item">
<!-- <li class="nav-item">
<a class="nav-link" href="./gsoc/">GSoC</a>
</li>
<li class="nav-item">
<a class="nav-link" href="./gsod/">GSoD</a>
</li>
<li>
<a class="nav-link" href="./governance/">Governance</a>
</li> -->
{{end}}

{{ispage blogposts/* || ispage tutorialposts/*}}
Expand All @@ -59,8 +66,15 @@
<li class="nav-item">
<a class="nav-link" href="https://fluxml.ai/Flux.jl/dev/ecosystem/">Ecosystem</a>
</li>
<li class="nav-item">
<!-- <li class="nav-item">
<a class="nav-link" href="../../gsoc/">GSoC</a>
</li>
<li class="nav-item">
<a class="nav-link" href="../../gsod/">GSoD</a>
</li>
<li>
<a class="nav-link" href="../../governance/">Governance</a>
</li> -->
{{end}}

{{ispage getting_started || ispage blog || ispage governance || ispage gsoc || ispage tutorials}}
Expand All @@ -79,11 +93,17 @@
<li class="nav-item">
<a class="nav-link" href="https://fluxml.ai/Flux.jl/dev/ecosystem/">Ecosystem</a>
</li>
<li class="nav-item">
<!-- <li class="nav-item">
<a class="nav-link" href="../gsoc/">GSoC</a>
</li>
<li class="nav-item">
<a class="nav-link" href="../gsod/">GSoD</a>
</li>
<li>
<a class="nav-link" href="../governance/">Governance</a>
</li> -->
{{end}}

</li>
<li class="nav-item">
<a class="nav-link" href="https://discourse.julialang.org/c/domain/ML" target="_blank">Discuss</a>
</li>
Expand Down
27 changes: 27 additions & 0 deletions gsod.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
+++
title = "Google Season of Docs"
+++

~~~
<h1>FluxML Projects - Season of Docs</h1>
~~~

The Flux project is a participant in Google Season of Docs. In 2020, we had a technical writer work on [our website](https://www.youtube.com/watch?v=6s9J-ObQaAs&feature=emb_imp_woyt). The project was a success and we have since then build out various projects specifically for interested technical writers.

[Flux.jl](https://github.com/FluxML/Flux.jl) is an elegant approach to machine learning in Julia. It is designed to be hackable and flexible, extendable, and exposes powerful AD tools. It also provides abstractions over the popular layers and optimizers used in neural networks. It is built with differentiable programming in mind. The mentors for this project are [Dhairya Gandhi](https://github.com/DhairyaLGandhi).

## Tutorials

Flux is in dire need of complete tutorials in the [model-zoo](https://github.com/FluxML/model-zoo.git) as well as on the website. We can take inspiration from many existing projects that publish their tutorials, that take a look at common design patterns. This includes writing custom adjoints, new optimizers, transfer learning, and writing performance-sensitive code for many common kinds of networks that many people would be interested in writing.
This could also include cases that help users write custom loss functions, and even putting Flux models behind a web server.

## Updated Documentation and DocTests

Flux documentation needs a lot of rework since our generic approach to development means there are many general use cases that we support but might be a bit subtle to discover. So in that case, we need to highlight such common cases and make them known in the documentation.
We would like to use doc tests to also increase our coverage of and documentation of many of the common patterns we see in differentiating Julia code.

### Potential Impact

Flux is an innovative approach to machine learning. This also means that not all the same patterns and assumptions truly hold when translating from a different framework. It also needs a way to communicate a compelling description of how to implement many of the user-facing niceties that one might need in the course of completing an ML project. Through this, we want to also find areas of improvement where we could offer a better user experience.

This would also greatly benefit the adoption of Flux in the larger ML ecosystem, which we feel is currently held back due to not having enough of these simple patterns documented in an approachable form. We want to see an increase in the number of contributors to the various packages too since that would help us improve our stack better. Flux also utilizes simple to understand and performant code, made possible by Julia, and through this, we also want to bring awareness to how our ecosystem has matured, and increase its adoption in research and industry.
7 changes: 6 additions & 1 deletion index.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,7 @@
~~~
<h5>Community team</h5>
~~~
Flux is maintained by community team (see our [governance model](/governance)).
Flux is maintained by community team (see our [governance model](./governance)).
Join us or talk to us on Zulip! 👉
@@
@@col-md,feature
Expand Down Expand Up @@ -261,6 +261,11 @@
<a href="https://beacon.bio"><img src="./assets/friends/beacon_biosignals.jpg"></a>
~~~
@@
@@col-md
~~~
<a href="https://www.amd.com"><img src="./assets/friends/amd-logo.png"></a>
~~~
@@
@@
@@
@@