FluxML / FluxML/fluxml.github.io

[Discussion]: Update and periodically test posts and model-zoo tutorials

Ouverte
#141 4 commentaires 1 réaction 0 personnes assignées Voir sur GitHub
Langage dominant
HTML
Étoiles
20
Forks
44
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

This is a placeholder issue for updating the existing tutorials and adding workflows to periodically test them.

My proposal's text -

> Flux's website has plenty of good tutorials, but some of them have been outdated for some
time. These tutorials go stale with every new Julia and Flux release making them unreliable
for newcomers. Additionally, as discussed with Dhairya Gandhi, the FluxBot can be used to
automatically test these examples, but it is currently not integrated with the FluxML
ecosystem. The bot would ideally run all the model-zoo examples on every PR created on Flux.jl.
This section would aim to -
> - Update the tutorials on Flux’s website.
> - Add tests to (or run) these examples to ensure they do not go stale.
> - Integrate FluxBot with the existing FluxML ecosystem and get it running.

I tried triggering the FluxBot (https://github.com/FluxML/Flux.jl/pull/2016#issuecomment-1207408307), but it did not respond. I am guessing that the bot is not deployed at the moment. I did find a buildkite-related file and a PR (https://github.com/DhairyaLGandhi/FluxBot.jl/pull/2) that probably aims to shift it to GitLab's CI, but I am not sure how and where it is deployed currently. I am also not sure if there is a way to run it locally for some personal test repositories.

For the tutorials, should I migrate them from `Flux.params` to `Optimisers.jl`, or would it be too soon? I will audit all the tutorials and update them as needed!

For testing, I think it would be straightforward to periodically test the model-zoo examples using Julia's doctests, as model-zoo is a Julia package. For the website, I think the -
```
doctest(source, modules; kwargs...)
```
definition of `doctest` should work.

Also, #136 aims to migrate this website to `Franklin.jl`. Is this still in progress or has this been abandoned? I can take this up if required (cc: @logankilpatrick @darsnack)!

I will start by adding these periodic tests to both the repositories!

cc: @DhairyaLGandhi @mcabbott @ToucheSir

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Piste de recherche

Commencez par auditer les tutoriels existants du site web de Flux et les exemples de model-zoo, puis lisez le point d’entrée doctest(source, modules; kwargs...) et les discussions référencées sur FluxBot et Flux.jl CI. Clarifiez où FluxBot est déployé ou peut être exécuté localement. Le travail est considéré comme terminé lorsque les tutoriels sont mis à jour et que des vérifications périodiques sont exécutées pour les deux repositories.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
julia
Domaine
ci-cd, documentation, testing
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
À clarifier
Accessibilité débutants
25/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.