by Barry4679 » Sun Aug 21, 2022 4:07 am
Rob_S wrote: ↑Thu Aug 18, 2022 11:29 am
Koodos, Barry, eloquently spoken (written) indeed.
Thanks. But our combined best efforts, with regard to the documentation, have harvested exactly zero.
The response on this topic is the same as it always is ... It is unwritten, but I read it as "", wrapped in an envelope of burnt out complacency. ... That's how you see it?
Keep up the good work Rob ... for my part I am totally tone deaf to the above message and its lack of responsiveness and apparent lack of give-a-crap.
I do however want to correct something that I wrote last time
Barry4679 wrote: ↑Thu Aug 18, 2022 3:29 am
The Online Help for this topic, in your index
is here, and as you can see it is just a dead end.
My eyesight is not 100%, so I didn't detect that this was not actually a dead-end ... ie. the page contains a
tiny link to this
Have you read that document? IMO, while it is not (yet) perfect, it is several things that the MM5 online manual is not:
- it is task based, ie. it consolidates and connects information that otherwise requires reading the whole online manual to stumble across, and even then you have to join the dots and fill in the missing pieces yourself
- it actually explains things ... rather than just pointing at them, leaving the reader not much wiser, and often with more questions than answers
- it is the result of collaboration and review (see its View History tab), whereas the current Online Manual is in a silo, and any incoming opinion seems to go directly to trash
As far as I can see:
- it has been updated for MM5, but is not part of the manual. .. ?
- and the manual doesn't seem to contain any link to it ... ?
One final thing. The current MM5 Online Manual, is clearly the result of a lot of work.
- it appears to be the work of just one person -- LowLander, so kudos to him
- he seems ho have been working with MM for 20 years, and a lot of what he has written reflects, and expects, that level of assumed MM background information and knowledge
- good documentation can only come from collaboration and beta testing (IMO)
- and since none of this has occurred, the current MM5 online help is not good documentation
- and BTW none of this is an ambush against LowLander .. I have made these comments directly and privately to him on a couple of occasions, but always with the same result.
Rob_S wrote: ↑Thu Aug 18, 2022 11:29 am
It might be added that well-written software should actually not require much documentation.
When you ask it to do something, it asks you the relevant questions, and then proceeds to do the job.
Performing sync might be another one of those where it should ask for the required settings, as opposed to us having to search out where to enter them first.
Admittedly moving your tracks might be one of the less frequent things one might need to do.
Yes, a Wizard function would be good addition.
But I think that a power user should have a good document to explain how to achieve normal, but potentially disruptive things like moving your collection, or moving to a different computer. .. I think that MM5 already acts too much as a AI, with limited visibility when things go wrong
A good example is Syncing, which you mentioned. I was going to sync .mp3 versions of my whole Collection to Dropbox, but it is not fit for use IMO ... not enough visibility, not enough control ... and when it breaks you just have start again, which is a show stopper when you have big collection.
[quote=Rob_S post_id=500281 time=1660840189 user_id=112670]
Koodos, Barry, eloquently spoken (written) indeed. :)
[/quote]
Thanks. But our combined best efforts, with regard to the documentation, have harvested exactly zero.
The response on this topic is the same as it always is ... It is unwritten, but I read it as "", wrapped in an envelope of burnt out complacency. ... That's how you see it?
Keep up the good work Rob ... for my part I am totally tone deaf to the above message and its lack of responsiveness and apparent lack of give-a-crap.
I do however want to correct something that I wrote last time
[quote=Barry4679 post_id=500278 time=1660811367 user_id=28275]
The Online Help for this topic, in your index [url=https://www.mediamonkey.com/wiki/How_can_I_move_my_music_to_a_new_hard_drive_or_computer_while_retaining_my_playcounts/playlists/etc.%3F]is here[/url], and as you can see it is just a dead end.
[/quote]
My eyesight is not 100%, so I didn't detect that this was not actually a dead-end ... ie. the page contains a [url=https://www.mediamonkey.com/wiki/Moving_MM_to_a_new_computer]tiny link to this[/url]
Have you read that document? IMO, while it is not (yet) perfect, it is several things that the MM5 online manual is not:
[list]it is task based, ie. it consolidates and connects information that otherwise requires reading the whole online manual to stumble across, and even then you have to join the dots and fill in the missing pieces yourself[/list]
[list]it actually explains things ... rather than just pointing at them, leaving the reader not much wiser, and often with more questions than answers [/list]
[list]it is the result of collaboration and review (see its View History tab), whereas the current Online Manual is in a silo, and any incoming opinion seems to go directly to trash [/list]
As far as I can see:
[list]it has been updated for MM5, but is not part of the manual. .. ?[/list]
[list]and the manual doesn't seem to contain any link to it ... ?[/list]
One final thing. The current MM5 Online Manual, is clearly the result of a lot of work.
[list]it appears to be the work of just one person -- LowLander, so kudos to him[/list]
[list]he seems ho have been working with MM for 20 years, and a lot of what he has written reflects, and expects, that level of assumed MM background information and knowledge[/list]
[list]good documentation can only come from collaboration and beta testing (IMO)[/list]
[list]and since none of this has occurred, the current MM5 online help is not good documentation[/list]
[list]and BTW none of this is an ambush against LowLander .. I have made these comments directly and privately to him on a couple of occasions, but always with the same result.[/list]
[quote=Rob_S post_id=500281 time=1660840189 user_id=112670]
It might be added that well-written software should actually not require much documentation.
When you ask it to do something, it asks you the relevant questions, and then proceeds to do the job.
Performing sync might be another one of those where it should ask for the required settings, as opposed to us having to search out where to enter them first.
Admittedly moving your tracks might be one of the less frequent things one might need to do.
[/quote]
Yes, a Wizard function would be good addition.
But I think that a power user should have a good document to explain how to achieve normal, but potentially disruptive things like moving your collection, or moving to a different computer. .. I think that MM5 already acts too much as a AI, with limited visibility when things go wrong
A good example is Syncing, which you mentioned. I was going to sync .mp3 versions of my whole Collection to Dropbox, but it is not fit for use IMO ... not enough visibility, not enough control ... and when it breaks you just have start again, which is a show stopper when you have big collection.