[Documentation]: Re-organize DocC

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

@MasterJ93 đang làm issue này rồi.

Từ ngày 26/11/2024.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

documentation good first issue
Summary

The DocC has several inconsistencies and navigational issues

Description

Several pages in the DocC are either outdated, inconsistent, difficult to read and understand, and/or out of place. This issue is simply to mark down all places where things are problematic and fix them accordingly. The result is a cohesive, more developer-friendly experience.

What type of issue is it?

Spelling, Grammar, Inconsistency, Outdated

ATProtoKit Version

0.20.0

Documentation Location

All parts of the DocC

Additional Context

There are many, many sections of the DocC that needs work. Below is a list of what needs to happen.

  • Completed
    ATProtoKit, ATProtoBluesky, ATProtoBlueskyChat, and ATProtoAdmin classes are currently put in alphabetical order (with respect to purely the methods) and grouped by the type of object. This is okay, but when it comes to classes with a ton of instance methods, it becomes difficult to find what you need.

    For each class, they need to be organized into different categories, depending on the class. More specifically, methods will need to be organized by task for each class, similarly to how URLSession in Foundation has their methods sorted by different tasks. This gives more opportunities to fit certain relevant articles (and potentially sample code and tutorials) within the sub-sections.

    For ATProtoBluesky in particular, it will be sorted by whatever records are available. They may also be sorted by certain tasks, if need be. ATLinkBuilder-related documentation may be able to fit there, too, since that protocol is most useful in there.

  • Completed
    Sample code needs to be made in order to help developers see a clear picture of what's going on. These include:

    • A macOS and Linux console app to showcase the ability to log in, create a simple post, and view raw Codable outputs.
    • A macOS and Linux GUI app to showcase the above, but in a way that's user-friendly.
    • An iOS app, showcasing how to integrate ATProtoKit into a SwiftUI project (using both the MVVM pattern, as well as the pattern Apple typically uses when showcasing SwiftUI (we're going to call it "MV" for now).
    • A Linux app that demonstrates running ATProtoKit in the server for the purposes of making a bot account. The example bot will post a random emoji every minute or five minutes, depending on the user's setting).
    • A macOS app that showcases how to view feeds (both logged in and logged out).

  • Completed
    Tutorials will also be made. They will include:

    • Creating a simple macOS or Linux console app that lets you log in, create a post, attach an external embed, and attach an image embed.
    • Create an iOS GUI app to integrate ATProtoKit in a SwiftUI application (both in MVVM and MV patterns).
    • Creating a server bot with logging in and creating a post.
    • Creating a macOS GUI app for getting records and deleting records.

  • Completed
    More articles need to be made.

    • Example projects that you can make with ATProtoKit

More things will be updated over time.

[!NOTE]
This will most likely be completed within the next several 0.x updates.

Ngôn ngữ chính
Swift
Star
226
Fork
40
Merge trung bình
5 giờ 8 phút
Pull request đã merge (30 ngày)
3

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 MasterJ93/ATProtoKit

Tất cả issue của MasterJ93/ATProtoKit

Issue tương tự

Thêm issue về Swift

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.