Re: [Pytables-users] Documentation for stable releases?

[Anthony S. <sc...@gm...>]

Hello Gaëtan,

Thanks for bringing this up and I think that older versions of the docs are
a fairly important thing to have. I have opened an issue for this on github
[1].  However, I doubt that I will have an opportunity to take care of this
in the short term.  So if you want to take care of this issue for the
benefit of yourself and all, I would love to see a pull request ;).

Be Well
Anthony

1. https://github.com/PyTables/PyTables/issues/236


On Mon, Apr 22, 2013 at 6:09 AM, Gaëtan de Menten <gde...@gm...>wrote:

> Hello all,
>
> TL;DR: It would be nice to have online documentation for stable versions
> and have pytables.github.io point to the doc for the latest stable
> release by default.
> ====
>
> I just tried to use the new out= argument to table.read, only to find out
> it did not work in my version (2.3.1). Then I tried to update my version to
> 2.4 since I thought it was implemented in that version because of the
> "2.4.0+1.dev" name at the top of the page which I thought meant "dev
> version leading to 2.4", or maybe to "2.4.1", but certainly not the next
> major release. I got even more confused because, after the initial failure
> with my 2.3.1 release, I checked the release notes... which I thought were
> for 2.4 because the title of the "release notes" page is "Release notes for
> PyTables 2.4 series" when it is in fact for the next major version...
>
> Here are a couple suggestions:
> * doc for stable releases (default to latest stable), bonus points to be
> able to switch easily from one version to another, a-la Python stdlib.
> * change 2.4.0+1.dev to 3.0-dev or 3.0-pre, and all mentions of 2.4.x
> * have new arguments to functions documented in the docstring for the
> functions (like in Python stdlib): "new in pytables 3.0" in the docstring
> for table.read() would have made wonders.
>
> Thanks in adance,
> --
> Gaëtan de Menten
>
>
>
> ------------------------------------------------------------------------------
> Precog is a next-generation analytics platform capable of advanced
> analytics on semi-structured data. The platform includes APIs for building
> apps and a phenomenal toolset for data science. Developers can use
> our toolset for easy data analysis & visualization. Get a free account!
> http://www2.precog.com/precogplatform/slashdotnewsletter
> _______________________________________________
> Pytables-users mailing list
> Pyt...@li...
> https://lists.sourceforge.net/lists/listinfo/pytables-users
>
>