Skip to content
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

Organizational changes to aid discoverability #637

Open
blowmage opened this issue Aug 5, 2016 · 3 comments
Open

Organizational changes to aid discoverability #637

blowmage opened this issue Aug 5, 2016 · 3 comments
Assignees

Comments

@blowmage
Copy link

blowmage commented Aug 5, 2016

One of the problems I see discussed over and over is that minitest is not as discoverable as other testing libraries for new users. RSpec has put a lot of effort into onboarding new users. Not only those familiar with testing, but those unfamiliar with it. I propose the following organizational changes to help newbs use minitest as well as start contributing to it.

  1. Make a GitHub organization

    Moving the repo from seattlerb to its own organization will allow use of a GitHub pages repo for the organization's website. This will allow those not ready to contribute to the code to contribute to the documentation. Improving the documentation is just a pull request away.

  2. Move minitest repo to the organization

    This means stopping use of the Mercurial bridge and allow the git repo to be where development happens. I believe this will encourage contributions because users will see their contributions reflected on the GitHub stats.

  3. Allow contributed gems to belong to the organization

    Not only should the seattlerb and zenspider minitest-gems belong to the organization, but established and supported gems as well. For example, minitest-rails and minitest-matchers. Belonging to the organization would be seen as a seal of approval.

I know this is a radical shift in your workflow, but I think it would help others get and stay involved. We have a great need for getting more people involved in the documentation effort.

@zenspider
Copy link
Collaborator

KK... Let me mull over this. I've been meaning to test out more friendly bridges that might allow for bi-directional work to git. Maybe I can find time to do that this weekend.

@zenspider zenspider self-assigned this Aug 5, 2016
@utilum utilum mentioned this issue Dec 16, 2016
@zenspider
Copy link
Collaborator

Done?

@blowmage
Copy link
Author

Wow, there has been so much progress on this! I agree 1 and 3 are completed, which is kinda blowing my mind. 🤯

The remaining proposed change is to move to the git repo as the source of truth. That would allow for others to manage the project easier, but constitutes a big change. What are your thoughts on 2 in 2022?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

2 participants