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

Documentation #85

Closed
artpelling opened this issue Apr 2, 2021 · 1 comment
Closed

Documentation #85

artpelling opened this issue Apr 2, 2021 · 1 comment
Labels
help wanted Extra attention is needed improvement Improvement suggestion

Comments

@artpelling
Copy link

artpelling commented Apr 2, 2021

IMHO the documentation for this project in its current state is not very thorough. It covers the basics, but makes it tedious to dive deeper into it. A lot of the times it feels like "reinventing the wheel" when trying to understand and change the source code or make new breakout boards. It is frustrating to constantly run into problems that somebody else has surely already found a solution for.
A community driven documentation page, where knowledge can be pooled publicly would help with this issue. I suggest to use the Wiki page here on github for that reason.
This would significantly help community building, making the project more attractive in general an would also drastically improve the experience for new users.

The impression I get from the project so far is that there the devs are busy with maintenance and bugfixes for "consumer level" users and resources for higher level support and development of new features are lacking. There is a discord channel with a few users, other than that there is a lot of discussion on the diy-hifi-forum which is only in German, has a closed registration and the overall quality of communication seems very inefficient there.

Providing a central place for a thorough documentation of custom builds and features users have implemented would also benefit the maintainers of this repo as a lot of question could be already answered here. Personally, I would be happy to write small tutorials/howtos of the solutions I found for several issues I have encountered.

Related to #23

@dspverden
Copy link
Collaborator

dspverden commented Apr 7, 2021

I like the wiki idea. I just enabled that feature, so nothing is there, yet, but feel free to add pages. I have made the wiki "public". Everyone with a GitHub account can contribute the wiki now. I hope I did the configuration right. If not, let me know.

@dspverden dspverden added help wanted Extra attention is needed improvement Improvement suggestion labels Apr 21, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed improvement Improvement suggestion
Projects
None yet
Development

No branches or pull requests

2 participants