git@vger.kernel.org list mirror (unofficial, one of many)
 help / color / mirror / code / Atom feed
* Re: List of Known Issues for a particular release
@ 2019-07-12 20:44 Mark T. Ortell
  0 siblings, 0 replies; 4+ messages in thread
From: Mark T. Ortell @ 2019-07-12 20:44 UTC (permalink / raw)
  To: Elijah Newren; +Cc: git

> test_expect_failure (as well as other helper functions in the test 
> harness library, such as test_expect_success, test_must_fail, 
> test_might_fail, etc.) are explained in t/README.  By its definition, 
> it technically satisfies "list of known issues" as you asked for.
> However, most software products that publish a list of known issues 
> has probably curated problems that users are likely to see or be 
> curious about, and which they want to inform users of both to reduce
>  support load and help users avoid problems.

Perfect, that answers my question. 

> This list is not curated in any such way.  It's just a list of issues 
> developers thought to document for themselves and/or other developers.
> It is thus way different than what you might want:
> 
> (1) There is evidence that some have used it for "In an ideal world, 
> this thing should support this feature too in which case I'd expect it 
> to behave a certain way that it doesn't yet."  The line between 
> feature (what works is fine but we could make it better) and bug (it's 
> not really correct if it doesn't do it this way) gets really blurry at 
> times, and you'd pick a much different tradeoff in communication 
> between developers than you would in communication from developers to 
> users; with other developers you spend a lot more time talking about 
> internals and goals and direction we'd like to move the software in.
> 
> (2) Also, some of these "known breakages" could be in corner cases 
> that are very unlikely to be hit be users, and perhaps not only likely 
> to be hit by individual users, but unlikely that anyone anywhere will 
> ever hit that error (some of the merge recursive tests I added might 
> fall into that category).
> 
> (3) There may also be cases where someone once thought that optimal 
> behavior would be a little different and that they were planning to 
> implement more features, and then later changed their mind but forgot 
> to clean up the testcases.
> 
> (4) ...and that's just a few off the top of my head.  I'm sure the 
> list has several other things that make it not quite match what you 
> want.

Thanks for the detailed clarification. This helps a lot. It may require a
bit of manual work sifting through these to see which could potentially
affect our use cases (very very unlikely any will, but that’s the due diligence
that is required for functional safety).

> As such, Brian's answer to your question elsewhere in this thread is 
> probably better than mine, but if by chance you are just being forced 
> to go through a box checking exercise and there's no reason for 
> needing these results other than that someone asked that they be 
> provided (I sometimes had to go through such exercises when I worked 
> at Sandia National Labs years ago), then technically the command I 
> gave you could be used to satisfy it.

Thanks Brian for your thoughts. We don't use much open source software
for our functional safety development (for this reason), so this is new 
territory for us. I think Elijah's information will get me most of the way there.

Also, I pulled down the source for the release version we are using and ran 
the test suite on it to have results that confirm that the software is working 
according to the design, so that is really helpful to have as well. 

Cheers,
Mark

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: List of Known Issues for a particular release
  2019-07-11 15:28 Mark T. Ortell
  2019-07-11 15:59 ` Elijah Newren
@ 2019-07-11 16:09 ` brian m. carlson
  1 sibling, 0 replies; 4+ messages in thread
From: brian m. carlson @ 2019-07-11 16:09 UTC (permalink / raw)
  To: Mark T. Ortell; +Cc: git

[-- Attachment #1: Type: text/plain, Size: 2436 bytes --]

On 2019-07-11 at 15:28:27, Mark T. Ortell wrote:
> Hello,
> 
> I am doing a software tool assessment for functional safety and I am reviewing the use of Git as the SCM. One thing that I need to do is review the list of "known issues" with the Git release being used. I have gone through the release notes and found that it only contains the fixes and enhancements in a particular release of Git, it does not contain a list of known issues/errata in a particular release. The github project also does not include the bug tracking list, so I am not able to figure out a way to review the known issues for a particular release. I considered reviewing the fixes in releases beyond the release used, but that has 2 problems. One, it doesn't contain any issues that are yet to be fixed. Two, only the fixes in the "next" release are truly relevant because fixes after that could have been introduced in a release after the release being used. An additional note is that the Git for Windows project does provide a list of known issues in the install
> 
> Could someone in this mailing list assist me in finding the known issues for a particular version?

It sounds like what you're asking is for a bug tracker that lists all
known issues. Git doesn't have one of those; we instead use the mailing
list for reporting issues. We've considered using a bug tracker in the
past, but the idea hasn't caught on yet.

The GitHub project is a mirror; it isn't the canonical resource, and the
Git project doesn't use it for issues or pull requests. Both of these
are also the same policy as for the Linux kernel[0], which you may or
may not use.

If you're looking for an easy way to check off a compliance box, you may
need to work with your management and/or auditors to see what approach
you use for other software (such as Linux) that has nontraditional bug
reporting practices. If you typically use a Linux distro that addresses
this issue for you, then you'll probably want to use Git from that
source as well.

Alternatively, you can use Git for Windows on a non-Windows system; it
should compile and run just fine on Linux, macOS, and Windows, although
it tends to carry more patches than Git itself.

[0] Yes, kernel.org has a bug tracker, but it is known to be incomplete
and many issues are raised only on the various mailing lists.
-- 
brian m. carlson: Houston, Texas, US
OpenPGP: https://keybase.io/bk2204

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 868 bytes --]

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: List of Known Issues for a particular release
  2019-07-11 15:28 Mark T. Ortell
@ 2019-07-11 15:59 ` Elijah Newren
  2019-07-11 16:09 ` brian m. carlson
  1 sibling, 0 replies; 4+ messages in thread
From: Elijah Newren @ 2019-07-11 15:59 UTC (permalink / raw)
  To: Mark T. Ortell; +Cc: git

On Thu, Jul 11, 2019 at 8:50 AM Mark T. Ortell <mtortell@ra.rockwell.com> wrote:
>
> Hello,
>
> I am doing a software tool assessment for functional safety and I am reviewing the use of Git as the SCM. One thing that I need to do is review the list of "known issues" with the Git release being used. I have gone through the release notes and found that it only contains the fixes and enhancements in a particular release of Git, it does not contain a list of known issues/errata in a particular release. The github project also does not include the bug tracking list, so I am not able to figure out a way to review the known issues for a particular release. I considered reviewing the fixes in releases beyond the release used, but that has 2 problems. One, it doesn't contain any issues that are yet to be fixed. Two, only the fixes in the "next" release are truly relevant because fixes after that could have been introduced in a release after the release being used. An additional note is that the Git for Windows project does provide a list of known issues in the install
>
> Could someone in this mailing list assist me in finding the known issues for a particular version?
>
> Best Regards,
> Mark Ortell

Probably not in the format you want, and likely including noise that
isn't relevant, but in a clone of git.git you could run:

git grep ^test_expect_failure t/

^ permalink raw reply	[flat|nested] 4+ messages in thread

* List of Known Issues for a particular release
@ 2019-07-11 15:28 Mark T. Ortell
  2019-07-11 15:59 ` Elijah Newren
  2019-07-11 16:09 ` brian m. carlson
  0 siblings, 2 replies; 4+ messages in thread
From: Mark T. Ortell @ 2019-07-11 15:28 UTC (permalink / raw)
  To: git

Hello,

I am doing a software tool assessment for functional safety and I am reviewing the use of Git as the SCM. One thing that I need to do is review the list of "known issues" with the Git release being used. I have gone through the release notes and found that it only contains the fixes and enhancements in a particular release of Git, it does not contain a list of known issues/errata in a particular release. The github project also does not include the bug tracking list, so I am not able to figure out a way to review the known issues for a particular release. I considered reviewing the fixes in releases beyond the release used, but that has 2 problems. One, it doesn't contain any issues that are yet to be fixed. Two, only the fixes in the "next" release are truly relevant because fixes after that could have been introduced in a release after the release being used. An additional note is that the Git for Windows project does provide a list of known issues in the install 

Could someone in this mailing list assist me in finding the known issues for a particular version? 

Best Regards,
Mark Ortell


^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2019-07-12 20:45 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-07-12 20:44 List of Known Issues for a particular release Mark T. Ortell
  -- strict thread matches above, loose matches on Subject: below --
2019-07-11 15:28 Mark T. Ortell
2019-07-11 15:59 ` Elijah Newren
2019-07-11 16:09 ` brian m. carlson

Code repositories for project(s) associated with this inbox:

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).