I’ve built out a docs/wiki website for our tech assets for our software developers.
Right now it automatically imports the Readmes from all of Resonate’s public code repositories of any significance and lays them out in a sequential and digestible fashion. This way, when we update the Readme on an existing repository, this wiki will also update (I believe we just need to run ‘USE_SSH=true yarn deploy’ from inside the repository directory and it downloads the updated Readmes and pushes out an updated build to the website). Kudos to @jeremy for the help researching and recommending documentation libraries that would be suitable for this.
We’ll want to improve upon this and expand on what’s here. This is just a first iteration and first step.
Here’s the repository. Feel free to create issues/pull requests if you see anything that needs changing, or discuss it in this thread.
Also, if you’re interested in seeing an overview of how this work is progressing, please check out the Kanban-style Project Board for the repository.
Another update went live moments ago: an Edit this page button has been added to the bottom of each set of instructions so users can easily update/modify/add to the instructions as they see fit by submitting a pull request via the link. We want to make updating our documentation as easy as possible, and I think this is a great first step!
The most significant changes of the changes can be seen on the Overview page:
The intro has also changed to feature beam as our primary front-end client for future development, and the navigation on the left-hand side has been re-organized to suit our current priorities regarding active development. Big kudos to @matt_burnett for his contributions to the git-workflow section!
I’ve also taken an initial stab at providing example API calls here, which was something that I believe @boopboop suggested at one point. These could eventually be made more focused and trimmed down probably. As it stands now, because beam will be updated to match changes that occur in the api repository, this will be an easy way to keep our docs website up to date, as it pulls directly from beam’s latest Api.ts file.
These are pretty significant changes, so if anyone has any suggestions regarding any of this, and in particular ways we could improve some of the wording of the overview section, it would be welcome!
This site is the official community for Resonate, a streaming music cooperative owned by the people who use it -- artists, labels, listeners and builders.