-
Notifications
You must be signed in to change notification settings - Fork 134
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
🎨 Create CONTRIBUTING.md guide for open source contribution #799
Comments
This is a fantastic idea! I think I remember there being a similar issue (or maybe a few of them?) being created at some point, but they've (obviously) not been taken up yet. Really good ideas in here! Edit: Here's the issue I was thinking of, although this one here is far more thorough and complete. |
@JFWooten4 Great idea, thanks for sharing |
🤣😂🙈 I'm glad everyone is impressed and likes my ideas. As you all can tell, a lot of work has been done, and as you can all tell, there is still Mork work ahead of me (US). 😇 On the serious side, I could use about 4 extra days in a week as unexpected ivence seems to be my better half, robbing me from all free time . Stretch to tin 🤴 I'm definition. Alt season just around the corner, and I'll have to prioritize that contributing to network well-being just in different way 😝 different approaches, better results, bringing capital and hunger for success investors to the Stellar ecosystem 😉 and giving you all time to proces fast pace of the amount of work is being done 2 jobs 2 business in 2 different tome zones 6h difference leaves me with will to do but no way to accurately do. BEST REGARDS YOURS CAPITAN 🫡 |
What problem does your feature solve?
GitHub content, community interactions, and actual code all coalesce into our collective documentation.1
Accordingly, we can create stellar docs detailing our knowledge, collectively describing how the network functions. 👩💻
Today's nonexistent contribution style guide leaves one person voicing opinions with a centralized SDF reviewer.2 This isn't fair for the reviewer's time, the contributor's confusion, or the browser's sanity. Moreover, a clear style guide can help developers independently build in line with our shared vision. 🌄
What would you like to see? 📝
A style guide under theACONTRIBUTING.md
page.CONTRIBUTING.md
file which explicitly details general collaboration styles.We respectfully submit that an independent Contributing page outside of
stellar-docs/README.md
would significantly further community collaboration since:Ultimately, might these guideposts steer us all towards a newfound documentation experience, without unnecessary missteps?3
What alternatives are there?
We could leave the community reviewers up to their own devices when manually looking over pull requests. This is what happens now, and contributions often get merged despite conflicting syntax. 🤔 I'm not saying that you must follow the guidelines 100% or else get rejected; just proposing that they exist in the first place when someone does want to follow the standard practice or clean up existing work.
We could use Stella, stricter
prettier
logic, or some other AI to automate the formatting amendments. 🤖Do nothing and leave my conscious unbearably restless, likely causing nightmares. 👻
Footnotes
See, e.g., the discussion of maximum network throughput getting fragmented between Discord chats, SDF posts, and GitHub PRs rather than actual ecosystem proposals, dedicated GitHub discussions, or public developer meetings. ↩
See, e.g., isolated discussions on example orders, cross-referencing, code spacing. ↩
See, e.g., one page which starts off using two space indents (most common throughout docs) and then transitions to using tab indention. These conflicts should be fairly simple to rectify using existing tools. It would also be nice to document when, where, and how to insert
README.mdx
files, in an effort to create a readable repository. ↩The text was updated successfully, but these errors were encountered: