Mailing-List: contact dev-help@corinthia.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@corinthia.incubator.apache.org
Received-SPF: softfail (nike.apache.org: transitioning domain of
 dennis.hamilton@acm.org does not designate 216.234.124.52 as permitted
 sender)
Reply-To: <dennis.hamilton@acm.org>
From: "Dennis E. Hamilton" <dennis.hamilton@acm.org>
To: <dev@corinthia.incubator.apache.org>
Subject: Test Documents (was RE: Coding Standards page)
Date: Thu, 8 Jan 2015 08:15:07 -0800
Organization: NuovoDoc
Message-ID: <009201d02b5e$47fdf410$d7f9dc30$@acm.org>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="utf-8"
Content-Transfer-Encoding: 7bit
Thread-Index: AdArWaGLOFoO0ec1QViTLqADp/Yrgw==
Content-Language: en-us
Received-SPF: softfail (supercp.com: domain of transitioning
 dennis.hamilton@acm.org does not designate 97.113.57.118 as permitted sender)

 -- replying below to --
From: jan i [mailto:jani@apache.org] 
Sent: Thursday, January 8, 2015 03:11
To: dev@corinthia.incubator.apache.org; Dennis Hamilton
Subject: Re: Coding Standards page

On 8 January 2015 at 00:40, Dennis E. Hamilton <dennis.hamilton@acm.org>
wrote:
[ ... ]
> It is OK to have binaries for test. Can you please add the right git
> attributes to the main test dir.
>
> <orcmid>
>    I don't see a main test dir anywhere.
>    If you know of specific file extensions for binary content that we have,
>    please update the .gitattributes file at the repository root.  I
> couldn't
>    Find anything with a quick scan of the repository.
>    (The SVN definitions are different and we don't use our SVN that way.)
> </orcmid>
>
<orcmid>
   When I went looking for a test directory, I found Peter's test documents.
   As well as I could determine, they are all .html files, so there is 
   nothing to do.

   Looking at the poi files, I see that there are many in binary formats.
   I could simply add those to the list of binaries in .gitattributes.
   It would be better to have some sort of files to confirm that the 
   .gitattributes is working, like a specimen of each file extension.

   I can make the .gitattributes changes.  It will need to be reviewed
</orcmid>
  
>
> My bad, I have one in my branch but it is not in the repo....I think went
away because peter moved test cases into docFormats, since they were all
white box testing.

We need a test dir at top level for black box tests, please create one. May
I suggest we add the poi test documents in a subdir, with a readme file
that informs the origin.

Dave@ thanks for your idea, and for sharing your concern...I think it is
better to have them in our git repo, so developers dont need multiple
version control clients.
<orcmid>
   I am not taking an action on creation of a test directory.  There is
   Need for more conversation on organization and whether to fork or to 
   fetch, etc., to be considered.  Also, there is no discussion yet
   of how tests themselves are conducted using whatever test documents
   there are.
</orcmid>

rgds
jan i

> [ ... ]
>
>