Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Things I would like to see in the developer documentation

Đang mở
  • Có gì không ổn?
#29 7 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
20/100
Loại issue
Tài liệu
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Đình trệ
Công nghệ
json, sql
Lĩnh vực
documentation

Hướng nghiên cứu

Đây là một danh sách mong muốn khá rộng thay vì một tác vụ dành riêng cho tệp, bao quát các chủ đề về Vala, GTK và GLib trong các lĩnh vực bố cục, văn bản, phương tiện, lưu trữ và tích hợp với elementary. Hãy bắt đầu bằng cách xem lại tài liệu dành cho nhà phát triển hiện có và thu hẹp danh sách chưa được đánh dấu xuống còn một chủ đề. Kết quả hoàn thành phải là một trang tài liệu hoặc ví dụ có phạm vi rõ ràng, với kết quả học tập được xác định.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
88
Fork
30
Merge trung bình
18 giờ 33 phút
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của elementary/docs

Tất cả issue của elementary/docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.