GTK tutorial missing with the new design

gtk-rs / gtk-rs.github.io

The gtk-rs.org website

http://gtk-rs.org/

23 stars 79 forks source link

GTK tutorial missing with the new design #220

Open alixinne opened 3 years ago

alixinne commented 3 years ago

The old design (before #205) used to feature a tutorial for GTK 3 users, including instructions for cross-compilation and various other details about how Rust wraps GTK.

This tutorial is referenced from various places, like the GTK 3 crate README for example (https://crates.io/crates/gtk), this link being currently broken.

Since GTK 4 isn't released, and the online book mentioned on the homepage doesn't cover the same topics, shouldn't the tutorial be kept online until new resources cover the same subjects or more?

Link to the old tutorial in case people visiting this issue need it: https://github.com/gtk-rs/gtk-rs.github.io/tree/617a9f8fb44f7fb0d338b4a6f4703815e7ea66a0/docs-src/tutorial

GuillaumeGomez commented 3 years ago

The tutorial to generate a binding using gir is also missing. I don't remember what we said about that either...

cc @sophie-h

sophie-h commented 3 years ago

I'm not responsible but iirc

[ ] The windows part was broken and @hofer-julian wanted add a chapter in the book.
[x] The gir part should probably move to the gir project @bilelmoussaoui?
[ ] Everything else probably belongs into the docs. Would be nice if someone checks what is not covered in the docs but in the tutorials.
[x] Also we could just grep through the docs (current and old) to find broken gtk-rs.org links.

Apologies for the chaos @vtavernier. Every help is appreciated.

Hofer-Julian commented 3 years ago

The windows part was broken and @Hofer-Julian wanted add a chapter in the book.

I've halted the work on the docker approach, since gtk4 for mingw64 is not packaged yet for fedora. I don't think we have anything reliable until that works.

The tutorial to generate a binding using gir is also missing.

Here we agreed that most of gir's README and the gir tutorial should be moved to a dedicated mdbook @bilelmoussaoui

bilelmoussaoui commented 3 years ago

I will move the gir tutorial to a mdbook hosted on gir repository sometimes next week.

soulflyman commented 2 years ago

I'm too missing the instructions on how to setup up a working environment in windows like the old one here or the new one for gtk4 here. I think this should be at least linked in some FAQ section on the page.

Also would it be nice to have back the basic explanation of the closures in the FAQ or tutorial section to understand what clone! does and that it exists. This is a important knowledge bit for begginers.

And I think the old glade tutorial was important too

And this one is also good to know when you start with gtk-rs

Maybe this is already covered by some documentation of gtk-rs itself, but when you are starting you first gtk-rs project it would be nice if the website, as the entry point, would take care of you and show you how to start and lead you to deeper knowledge.