Good morning Alex, Am 19.06.2022 22:43 schrieb Alex S.:
Maybe I will create a pull request, if no one else does this and there is no resistance ;)
No resistance from me. I am happy with every piece of documentation. Am 19.06.2022 22:43 schrieb Alex S.:
I think your idea of a section "Known Problems and Workarounds" on Github's README.md would really be helpful (better than the wiki page I suggested).
I think README.md is a good start; quick and easy. Then we see how it develops and what the content of that section really is. Maybe I misunderstand term "Known Problems and Workarounds". When there is a "problem" with BIT or a situation where you need a "workaround" for than it is a bug. In that case there should be an open Issue with all relevant information's to reproduce and workaround that problem/bug/issue. Because of that understanding I wouldn't say that we need an extra README.md or wiki section for that because we still have the Issues open; it would be redundant documentation. But I suppose you mean something like edgy use cases or rare situations. An example what comes into my mind is the migration of a backup setup. BIT runs on your PC and stores the files via Samba or SSH on another NAS in your local network. Then you completely reinstall your PC or you buy a new one. How to install BIT and set it up that way that it goes on with the still existing backups on the NAS? It is possible and I have done this multiple times. But it is not (good) documented. Did you mean something like this? Just my thoughts. Anyway. Just do it so and we will see what the content of this sections is. ;) Another idea that comes to my mind. For an answer to the "is that project dead" question in Issues, we should have a section (in wiki, faq or your "known problems") where we can link to and then close the Issue. Would save time. ;) By the way there still is a FAQ section in the wiki https://github.com/bit-team/backintime/wiki/FAQ It seems to me that most of its content covers use cases and user-problems (not bugs). Kind Christian