Re: Sample command line workflow with git and gerrit

[Alexis La Goutte <alexis.lagoutte () gmail com>]

On Wed, Feb 26, 2014 at 3:08 AM, Evan Huus <eapache () gmail com> wrote:

> On Tue, Feb 25, 2014 at 8:57 PM, Hadriel Kaplan
> <hadriel.kaplan () oracle com> wrote:
> > On Feb 25, 2014, at 8:44 PM, Evan Huus <eapache () gmail com> wrote:
> >
> > > I'm all for consolidating the above information - we just need to
> > > decide which of the many places to consolidate *to*. We've been
> > > playing musical chairs every few months moving things around from A to
> > > B, B to C, and C to A, but never actually getting anywhere.
> >
> > Personally I think the wiki makes the most sense, because none of that
> stuff is specific to the code version/branch/state; as opposed to the info
> in most of the docs/READMEs, which are specific to the release.
> > Also we can subscribe to changes of that wiki page, and thereby get
> notified via email of changes instead of happening to notice a change in a
> txt/asciidoc file in the code tree.
> > It's really the kind of thing a wiki's for, imo.
>
> That makes sense to me. So more broadly, how about:
> - user documentation in the user guide as asciidoc (currently in
> docbook/ in git, though I guess that should be moved since it won't be
> using docbook anymore)
> - developer documentation on the wiki
> - api documentation in doxygen
>
> If this makes sense to everyone, then:
> - the wiki needs a major structural cleanup, much of it is quite
> stale; I am half-tempted to wipe everything (or namespace it to old-*
> or something) and start fresh
+1 no a bad idea...


> - wireshark's doxygen output needs to be made more accessible (it's
> already hosted publicly somewhere but I couldn't find a link to it)
> - the developer guide and doc/README.* need to be parcelled up between
> the wiki and doxygen comments, then removed
> - the user's guide should be converted to asciidoc like the developers
> guide, and then moved to doc/
>
> Thoughts?
> ___________________________________________________________________________
> Sent via:    Wireshark-dev mailing list <wireshark-dev () wireshark org>
> Archives:    http://www.wireshark.org/lists/wireshark-dev
> Unsubscribe: https://wireshark.org/mailman/options/wireshark-dev
>              mailto:wireshark-dev-request () wireshark org
> ?subject=unsubscribe
___________________________________________________________________________
Sent via:    Wireshark-dev mailing list <wireshark-dev () wireshark org>
Archives:    http://www.wireshark.org/lists/wireshark-dev
Unsubscribe: https://wireshark.org/mailman/options/wireshark-dev
             mailto:wireshark-dev-request () wireshark org?subject=unsubscribe