Wireshark-bugs: [Wireshark-bugs] [Bug 9869] New: Documentation for GIT is horrible
Date Index · Thread Index · Other Months · All Mailing Lists
Date Prev · Date Next · Thread Prev · Thread Next
From: bugzilla-daemon@xxxxxxxxxxxxx
Date: Mon, 10 Mar 2014 20:00:22 +0000
Bug ID 9869
Summary Documentation for GIT is horrible
Classification Unclassified
Product Web sites
Version N/A
Hardware x86
OS Windows 7
Status UNCONFIRMED
Severity Major
Priority Low
Component Code review - code.wireshark.org
Assignee bugzilla-admin@wireshark.org
Reporter mykaul@gmail.com 

Build Information:
Paste the COMPLETE build information from "Help->About Wireshark", "wireshark
-v", or "tshark -v".
--
While I'm very familiar with both GIT and Gerrit, and have worked with both on
several other open source projects, Wireshark's documentation is horrible
(unlike most of everything else in Wireshark, which is in very high quality
usually!):
1. There's not a SINGLE source of information on how to submit patches.
- https://code.wireshark.org/review/Documentation/user-changeid.html
- https://code.wireshark.org/review/Documentation/user-upload.html (which is a
BTW mentions the need for ChangeIDs)
- https://www.wireshark.org/develop.html - which mentions you need to create an
account on Gerrit, but not how to do so.

Why not a single, streamlined instruction page?

2. The examples, instead of being concrete, provide a different URL each time.
Example: https://code.wireshark.org/review/Documentation/user-changeid.html
mentions review.example.com - why not code.wireshark.org ?
Or git push ssh://john.doe@git.example.com:29418/kernel/common
HEAD:refs/for/experimental in
https://code.wireshark.org/review/Documentation/user-upload.html

You are receiving this mail because:
  • You are watching all bug changes.