-
Notifications
You must be signed in to change notification settings - Fork 761
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
Moving CONTRIBUTING.md and DEVELOPING.md to wiki pages #4480
Comments
👍
👍
what is included in "all project docs"? other than that all sounds good to me, thanks!! |
DEVELOPING.md, CONTRIBUTING.md, and anything worth salvaging from the "development" section of the supercollider website |
awesome, let's do ih |
sick |
alright check it out, i moved CONTRIBUTING.md to become the "Guide for New Contributors," did some major updates to the out-of-date parts, and broke off the pull requests part to its own page. some further revisions are necessary, but at least they're way more convenient to edit now: https://github.com/supercollider/supercollider/wiki DEVELOPING.md is now the "Developer Reference". it is way too long and i intend to split it into separate pages. @brianlheim do the names "Guide for New Contributors" and "Developer Reference" sound good to you? it will be hard to change them afterward because github's wiki creates the URL based on the page title, so i just want to finalize those |
thanks @snappizz! Guide for New Contributors sounds good to me. As we discussed on slack I agree it would be a good idea to break up the developer reference page into a couple subpages and then reference them from the main wiki page, which will then become a kind of overview of guides and references. let's leave this issue open until contributing.md and developing.md have been updated. |
Motivation
our developer documentation is split in a few different places:
this fragmentation is confusing and makes the docs harder to edit effectively, especially with the in-repo markdown files cross-referencing the project wiki.
a quick check of the history of CONTRIBUTING.md and DEVELOPING.md shows that they are not often edited compared to the wiki pages. i attribute this to the amount of time it takes to open up a pull request and go through the review process. it's just more convenient to edit the wiki directly, and that's why most of our dev docs have gone there.
furthermore, development processes are not really specific to the SC version, so keeping them embedded in the git repo history isn't necessary.
this is motivated by recent efforts to help with onboarding new code reviewers, where there's been a lot of confusion due to lack of project documentation. the first step is to make them more convenient to write and edit.
Plan for Implementation
i will do the following:
The text was updated successfully, but these errors were encountered: