samba - Mar 2017 - Error in https://wiki.samba.org/index.php/User_Home_Folders

Am 07.03.2017 um 19:52 schrieb Rowland Penny via samba:
>>> Just checked with 'Computer Management' on Win7 and you
could be
>>> right, in fact, the entire page seems wrong, I wonder what version
>>> of Windows Marc used ?
>>
>> I really don't understand why you are saying that the _entire_ page
>> is wrong?
>>
>
> Perhaps 'wrong' is the wrong word ;-)
>
> What I meant was, If I run Computer Management on Win7 , I do not get
> the same options shown in the screenshots on that wikipage, so I cannot
> set things as shown.

The next time, please say
 > the button shown on the screenshot does not exist on Win7 and
 > the share permission for Authenticated User is incorrect.
instead of
 > the entire page seems wrong.

It's very frustrating if you spend 8 hours writing such an instruction 
and get this kind of feedback. (Yes, that's the amount of time I need 
for a doc of this size and complexity including testing.)

I just mentioned this because it's not the first time I read such 
comments. This really frustrates me, makes me thinking that I'm wasting 
a lot of my spare time, and often keeps me away from writing new content 
for a while.

Regards,
Marc

On 2017-03-07 14:05, Marc Muehlfeld via samba wrote:
> It's very frustrating if you spend 8 hours writing such an instruction
and get this kind of feedback. (Yes, that's the amount of time I need for a
doc of this size and complexity including testing.)
> 
> I just mentioned this because it's not the first time I read such
comments. This really frustrates me, makes me thinking that I'm wasting a
lot of my spare time, and often keeps me away from writing new content for a
while.
> 
> Regards,
> Marc
Please don't get frustrated about this. 

The challenge you have, as you are aware, is you are writing
documentation for a "moving target". "What worked for that
(older)
version is now like this and this (newer version) is better" may be true
and may not be true but that change effected your documentation
instruction. You cannot help that that happened. 

I have always found your documentation, the docs here on the samba wiki,
to be accurate and very useful. Keep up the great work!! 

Obviously the OP does not keep up with what is happening here. Not his
fault, I am sure he/she is only trying to help and suggest.

-- 
_______________________________

Bob Wooden of Donelson Trophy

On Tue, 7 Mar 2017 21:05:44 +0100
Marc Muehlfeld <mmuehlfeld at samba.org> wrote:
> The next time, please say
This is email, I know what I meant, but you didn't, so I must try
harder next time.
>  > the button shown on the screenshot does not exist on Win7 and
>  > the share permission for Authenticated User is incorrect.
> instead of
>  > the entire page seems wrong.
> 
> It's very frustrating if you spend 8 hours writing such an
> instruction and get this kind of feedback. (Yes, that's the amount of
> time I need for a doc of this size and complexity including testing.)
I understand how you feel, but don't get discouraged, any feedback is
better than no feedback, people only tend to say something if there is
a perceived problem and then only if they can be bothered to.
 
Rowland

>The next time, please say
>> the button shown on the screenshot does not exist on Win7 and
>> the share permission for Authenticated User is incorrect.
instead of
>> the entire page seems wrong.
>It's very frustrating if you spend 8 hours writing such an instruction 
>and get this kind of feedback. (Yes, that's the amount of time I need 
>for a doc of this size and complexity including testing.)
>I just mentioned this because it's not the first time I read such 
>comments. This really frustrates me, makes me thinking that I'm wasting 
>a lot of my spare time, and often keeps me away from writing new content 
>for a while.
>Regards,
>Marc
Hi,

 
I was the one suggesting the Windows 7 info.

Please do not take these suggestions as a token of ingratitude, they were a mere
expression of the desire for completeness. In fact, I was able to find the
correct Windows 7 settings by looking at the Windows 10 info. 

We should all acknowledge the effort some people make in the open source field,
especially as these efforts are rarely compensated in monetary ways. 

Maybe we should call upon more volunteers to do stuff like adding wiki info.

 
 
BC

Hi Bart,

Am 07.03.2017 um 22:47 schrieb Bart Coninckx via samba:
> I was the one suggesting the Windows 7 info.
>
> Please do not take these suggestions as a token of ingratitude,
 > they were a mere expression of the desire for completeness.
 > In fact, I was able to find the correct Windows 7 settings
 > by looking at the Windows 10 info.

Don't worry. I wasn't complaining about your post. You reported an 
mistake in the guide. I really appreciate this and directly fixed it in 
the doc.

My reply regarding your suggestion about having individual pages for 
each Windows version was just to tell why we should avoid this.

My frustration came up by a different comment in this thread.

Regards,
Marc

Am 07.03.2017 um 21:35 schrieb Rowland Penny via samba:
 >> The next time, please say
 >>
 > This is email, I know what I meant, but you didn't, so I must try
 > harder next time.
 >>
 >> > the button shown on the screenshot does not exist on Win7 and
 >> > the share permission for Authenticated User is incorrect.
 >> > instead of the entire page seems wrong.
 >>
> I understand how you feel, but don't get discouraged, any feedback is
> better than no feedback, people only tend to say something if there is
> a perceived problem and then only if they can be bothered to.

I did not complain if people report bugs in docs I wrote. I really 
appreciate usable feedback to improve the docs.

I talked about comments like "the entire page seems wrong". This is no
feedback. This only means that the author was incapable to produce 
something that doesn't work at all.

I'm frustrated by people not providing useful feedback or with respect. 
The ones who always know everything better and always force me to 
justify everything I wrote, without having ever provided a single page 
of documentation in the Wiki. Or at most just added/updated a few 
sentences occasionally, while I spend 10-15 hours each month to refresh 
docs, write new guides, test procedures, and update instructions before 
we ship a new major version.

Regards,
Marc


PS: In the end it might not matter what Windows version I use to capture 
screenshots on. I use screenshots only in exceptions to show things that 
are difficult when wrapped in text. If I know about any differences on 
other versions, I add a sentence next to the image. However, it makes 
more sense to me to use Win10 for the screenshots than from an outdated 
OS. I also don't use the output of Samba 4.4 commands in the guides, if 
there are newer versions available. If you think we should better 
provide docs that contain eight year old Win7 screenshots, please upload 
new images. Don't complain - just do.

<EOT>