🙏 How can we make GitHub easier to learn, use, or view?

[JFWooten4]

Would love to hear from some of the users who expressed confusion in navigation

Originally commented by @tehchives in WhyDRS/.github#19 (comment)

---

As we work on a general Ape's Introductory Guide,¹ it'd be super helpful to hear how we can make this platform easier for everyone to leverage. For context, there is an introductory post with an initial section walking through GH account creation. If that doesn't work,² please feel free to ping me in the Discord!

Even if you've had smooth sailing in the org, we'd love to hear about your experience—what worked well for you and what stood out as positive. If something felt especially intuitive, let us know so we can build on those strengths. Your feedback will directly shape how we structure resources and onboard new members in the future—thank you for helping us improve!

Footnotes

1. And some aspects of the DUNA docs ↩

2. Or you get a weird spam slap like Altair—whoops! Thanks for the update from James affirming their return. 🍌 ↩

[JamesAlfonse]

I think this is an important discussion, tagging some people that have commented or created an issue recently for visibility.

@LastResortFriend @bobmahalo @greengiantyo @jergy2 @AltairAster @jackofspades71

[LastResortFriend]

So as far as getting people up to speed on Github we need our education material to meet a few criteria:

It must be text and picture based. While videos are nice they do present a small mental barrier for people just wanting to "do it" right away, which is an energy that can't be wasted.

Instructions must be clear, concise, highly purposed, and paired with pictures at appropriate intervals. Instructions should also only apply to basic features required for function, stuff like how to bold sentences can be found by the user - it's our job to make sure they can meet minimum communication and functional standards for basic participation.

Finally they must be displayed where users will find them the most useful, if we want a bunch of users from the Discord for example there should be a dedicated channel their for Github tutorials, progressing from basic to advanced.

If we keep these things in mind I believe we'll find great success.

[LastResortFriend]

Although perhaps videos will still be helpful for other users, everyone learns differently.