I think it will be good to have big warnings at the top of old doc pages, as Jason Moore said.
-- Shekhar On Friday, 23 June 2017 01:22:38 UTC+5:30, Jason Moore wrote: > > 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 [email protected]. To post to this group, send email to [email protected]. 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/68a36c45-5229-4265-9a0c-ad0d7bc653e3%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
