Re: [IBMiOSS] The README for 5733-OPS Option 3

On Thu, Sep 1, 2016 at 1:51 PM, Aaron Bartell <aaronbartell@xxxxxxxxx> wrote:

As best I can tell the README.md is accurate and up to date. Maybe it
would be good to further explain how the .lst files work. There are cases
where you'd want a specific version of a given package and by having, and
keeping, multiple versions for, say, git, we are able to allow people
flexibility. The alternative would be to have only one pkg_perzl_git.lst
and always having it contain the latest and not support the install of
older versions.

Well, the fact that you are talking about .lst files for Git and there
is no mention of such in the README.md is itself a reason for me to
consider it inaccurate or outdated.

Yes, it mentions Git, but not any pkg_perzl_git-*.lst files.

Also, the document refers to itself as README.txt, which is clearly no
longer the case.

But actually neither of those is what caught my eye. In case it was
not clear, when I brought up the comments being out of date, I meant
that casual onlookers who see things like

- pkg_perzl_python-2.6.8.lst -- most popular python for Linux (recommend)
- pkg_perzl_python-2.7.5.lst -- last great python 2, too bad not
widely used (hint)

will take that to mean that Python in the Linux world is dominated by
2.6, and that 2.7 is not too common. These statements *might* have
been true when those perzl packages were new. Might. They are
categorically NOT true now.

I've already acknowledged that maybe the comments are appropriate in
the context of the perzl ecosystem, and thus maybe should just be left
alone (to wither on the vine).

John Y.