Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Things I would like to see in the developer documentation

オープン
#29 コメント 7 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
20/100
issue の種類
ドキュメント
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
json, sql
領域
documentation

調査の方向性

これはファイル単位のタスクというより、Vala、GTK、GLib に関するレイアウト、テキスト、メディア、ストレージ、elementary との統合を扱う幅広いウィッシュリストです。まず既存の開発者向けドキュメントを確認し、未チェックのリストを 1 つのトピックに絞り込んでください。完了時には、学習成果が明確に定義された、範囲の明確なドキュメントページまたは例になっている必要があります。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
言語のデータがありません
スター
88
フォーク
30
平均マージ
18時間 33分
マージ済み PR(30日)
2

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

elementary/docs のほかの issue

elementary/docs の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。