It seems that many other scipy related packages handle this by giving big warnings at the top of old doc pages to manually redirect you. This seems to work for me the vast majority of the time, only occasionaly to I get stuck on old, for example. Readthedocs does this for your automatically too and has a nice sidebar that tells you what version of the docs you are on.
I'm not in favor of removing old docs because it is a real pain for the user to build old docs. I'd be more in favor of warnings on old doc pages. On Thursday, June 22, 2017 at 12:38:28 PM UTC-7, Aaron Meurer wrote: > > Hello all. > > I would like input from the broader SymPy community here. Right now, > at http://docs.sympy.org/ we have versioned docs for each version > going back to 0.6.7, e.g., http://docs.sympy.org/0.7.3/index.html. > > I am proposing to remove these. The only docs that would be on the > docs site are http://docs.sympy.org/latest/ (the default) and > http://docs.sympy.org/dev/ (built automatically from master). I am > undecided if existing versioned docs pages should be setup to redirect > to latest, provide a message, or just 404. > > Two reasons why I want to do this: > > - Empirically, many users end up on old docs pages, without > intentionally going there. Google search likes to return search > results from old docs pages. We have attempted to use the webmaster > tools to fix this, but just playing around with some random search > terms, it seems they still appear in the top of the results (e.g., > "sympy ln" gives 0.7.1 docs as the first result). > > - This gives the false impression that we support older versions. We > do not support any version of SymPy other than the latest version. We > do not make backport releases, except in extreme situations. > > I am looking for feedback on this, whether you think it's a good idea, > a bad idea, or any suggestions. > > Aaron Meurer > -- You received this message because you are subscribed to the Google Groups "sympy" group. To unsubscribe from this group and stop receiving emails from it, send an email to sympy+unsubscr...@googlegroups.com. To post to this group, send email to sympy@googlegroups.com. Visit this group at https://groups.google.com/group/sympy. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/0b37c004-410b-4b4c-9b26-04375ac9392a%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
