Mailing-List: contact users-help@maven.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Maven Users List" <users@maven.apache.org>
Received-SPF: pass (athena.apache.org: local policy)
Date: Fri, 15 Mar 2013 12:34:31 -0400
From: "Mark H. Wood" <mwood@IUPUI.Edu>
To: users@maven.apache.org
Subject: Re: Unpacking jars into target/classes
Message-ID: <20130315163431.GB14255@IUPUI.Edu>
Mail-Followup-To: users@maven.apache.org
References: <513261C4.2030600@durchholz.org>
 <CAGZB7RgCNc9G8dhhJ-OZbU6Kccm9S1sqiG_92EwyDse9V=GXsg@mail.gmail.com>
 <5138524B.6090405@durchholz.org>
 <kh9l07$rbr$1@ger.gmane.org>
 <CANWgJS61bGneBfS48edR3Dx5KZN0sciF6zmHCdL6+cdwQg23fg@mail.gmail.com>
 <513880C1.8030007@durchholz.org>
 <CA+nPnMyU3qfz_p=q3XiYoaBtZzRnpHP3vewYvSBQeadrhOAnmg@mail.gmail.com>
 <51388E21.5040804@durchholz.org>
 <CADVp3v-BEYTpoG6Gt+ePqseaN-bpp+-0=P8LKwnWdHY9eEYLZA@mail.gmail.com>
 <51427CEE.9000608@artifact-software.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="+g7M9IMkV8truYOl"
Content-Disposition: inline
In-Reply-To: <51427CEE.9000608@artifact-software.com>
User-Agent: Mutt/1.5.21 (2010-09-15)

--+g7M9IMkV8truYOl
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Mar 14, 2013 at 09:44:14PM -0400, Ron Wheeler wrote:
> How do you write documentation for something that you have never used=20
> and have no idea what the options are?

Exactly!

You grumble a bit, pull down the source, and start reading.  This is
horrible and exhausting and often underappreciated, but it's the only
thing that works, it the author won't share his thoughts.

> I have worked on documentation for some projects but I can only go so=20
> far without the active involvement of the author.
> The biggest thing that I can bring is my ignorance which makes me read=20
> what is there and ask good questions about WTF does it mean and what=20
> needs to be said so that someone who did not write it can use it.
> It does require access to someone who can answer those questions.

Hear, hear.  I'm sure that a large part of technical writing is spent
interviewing (not to mention identifying, finding, chasing and
hounding) the people who know that which must be written down.

--=20
Mark H. Wood, Lead System Programmer   mwood@IUPUI.Edu
There's an app for that:  your browser

--+g7M9IMkV8truYOl
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (GNU/Linux)

iEYEAREIAAYFAlFDTZcACgkQs/NR4JuTKG+nZACgi0SiZ50N5GU4jhkzwZ6C5oqR
AvUAn3KlpP6lS5MhCYSdcNBpCZvJgaop
=riFo
-----END PGP SIGNATURE-----

--+g7M9IMkV8truYOl--