Re: Wireshark User's Guide comment/suggestion

[Jaap Keuter <jaap.keuter () xs4all nl>]

Hi,

So you’ve noticed that the community consists more of programmers than documentalists. Getting the software right is 
difficult enough, let alone the various guides. 

That being said, the format of the user and developer guide has been converted from DocBook into AsciiDoc, but somehow 
the version information got dropped when setting up the new title page. I can’t find if or why this was done, either on 
purpose of by accident. It would be simple enough to push a change to have it included (again). 

As for the rest of the content, we (the Wireshark Core Developers) depend on the community to send in changes, to 
improve the documents. E.g., the MATE documentation was recently added to the Users’ Guide because of the excellent 
graphics provided by a community member.

Thanks,
Jaap


> On 14 Jun 2018, at 16:51, R. Martindale <RMartindale () msn com> wrote:
>
> While reviewing what I presume to be the current Wireshark User’s Guide 
> (https://wireshark.org/docs/wsug_html_chunked/index.html <https://wireshark.org/docs/wsug_html_chunked/index.html>), 
> I was unable to find any mention of the version of Wireshark to which the guide applies.  Some of the screenshots in 
> the guide differ from what I am seeing on my screen when I run Wireshark under Raspbian GNU/Linux ver 9 (stretch).
>  
> I respectfully suggest that the Forward of the user’s guide (Preface, Section 1) should identify the Wireshark 
> version for which the guide was targeted and from which the various screenshots were captured. 
>  
> The way in which obsolete content seems to live forever on the internet makes finding useful information all the more 
> difficult when its applicability or effectivity is not cleared stated.  I frequently find tutorials, how-tos, and 
> other information which at first glance seems useful, but which turns out to do more harm than good because it 
> applies to a particular configuration that is not clearly identified and which differs from what I am using.
>  
> Thanks for your work on Wireshark and for giving this suggestion some consideration.
>  

___________________________________________________________________________
Sent via:    Wireshark-dev mailing list <wireshark-dev () wireshark org>
Archives:    https://www.wireshark.org/lists/wireshark-dev
Unsubscribe: https://www.wireshark.org/mailman/options/wireshark-dev
             mailto:wireshark-dev-request () wireshark org?subject=unsubscribe