Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Things I would like to see in the developer documentation

Offen
  • Stimmt etwas nicht?
#29 7 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
20/100
Issue-Typ
Dokumentation
Klarheit
Muss geklärt werden
Aktivitätsstatus
Veraltet
Tech-Stack
json, sql
Bereich
documentation

Rechercherichtung

Dies ist eher eine breit gefasste Wunschliste als eine dateispezifische Aufgabe und umfasst Themen zu Vala, GTK und GLib in den Bereichen Layouts, Text, Medien, Speicher und elementary-Integration. Beginne mit der Durchsicht der vorhandenen Entwicklerdokumentation und grenze die nicht abgehakte Liste auf ein Thema ein. Als erledigt gilt eine klar abgegrenzte Dokumentationsseite oder ein Beispiel mit einem definierten Lernergebnis.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Hello,

Since Dan has talk about improving the documentation in G+, I have made a list of what I have try to learn when getting started with Vala.
But in one month, I haven't find the time to create proper bugs reports, and I will have even less time the next 2 month, so, even if it isn't awesome I am just gonna put it here.

A little background here : I am in my last year of college, really passionate about Gnu/Linux in general, and more particularly elementary. I have try 3 or 4 time to build a simple 3rd party elementary app, and eventually give up each time because it took me really a long time to find how to do Gtk stuff, and the best source was understanding other 3rd party elementary apps.

Vala isn't too hard to pick up. I was already familiar with object oriented programming, so I have build a Game, and an IA for this game as a student project in a month or two.

The hard part IMO, is getting started with GTK and GLib libraries. I have to say that I am not really familiar with the creation of interfaces (well, I had a course about QT, but I didn't do much). And blog post about creation of Gtk interfaces in Vala are really hard to found.

Down here, a list of things I have search about, and that I would love to see into the documentation :

Common layouts :

  • How to do a Headerbar
    • add a Popover
    • add a Menu
    • change the color to set a brand
  • Welcome View
  • Stack and Stack Switcher
  • How to do a Sidebar (classic, with sourceview, only with big icons)
  • Cover view (the list of albums in noise)
  • TreeView (second view in Noise)
  • #194
  • Pantheon mail list (that list of mails, I never figure out how to do it)

Playing with Text :

  • Text View
  • Customising Text (bold, size, color)
  • Text Editing
  • WebKitView

Playing with media :

  • Displaying an Image
  • Playing some audio
  • Playing a Video

Storing Data :

  • Gsettings
  • SQL db
  • "Open a File" Dialog
  • Getting Data from a Rest API
  • Reading data from JSON

Pro tips :

  • Keyboard Shortcuts
  • Right Click

Integration with elementary :

  • Notifications
  • Number above icons in Plank
  • Contractor

Again, sorry for just putting that here and not doing a propers bugs reports.

Vorherrschende Sprache
Keine Sprachdaten
Sterne
88
Forks
30
Ø Merge
1 T. 9 Std.
Gemergte PRs (30 T.)
1

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus elementary/docs

Alle Issues in elementary/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.