I disagree. 404'ing the old docs is not the correct action. 404 means "not found", but the user is requesting a page that he (and you) know exists... it's just not at that location any more. Thus, a redirect is the way to go. I'd suggest the following
- Move the old docs somewhere they're still available, but under a different URL. - 301 (or 302) redirect old URLs to the new documentation as appropriate - In the new documentation, provide a "old API docs" link to wherever you moved the old docs to, so people can still get to them if they need to. - Set up robots.txt file to tell search engines to ignore the old docs - rwk On Tue, Apr 6, 2010 at 2:00 AM, Tobie Langel <tobie.lan...@gmail.com> wrote: > A practical solution would be a well designed 404. > > We could get pdoc to generate it with a search field, etc. > > We could also try JS redirection. > > Anyone wants to give it a shot? > > Best, > > Tobie > > On Apr 6, 8:42 am, "T.J. Crowder" <t...@crowdersoftware.com> wrote: > > > My coworkers still find old docs (http://prototypejs.org/api) by > googling. I > > > had to point them to new doc site. I think it's crucial to set up 301 > > > redirects. > > > > *ONLY* if all of the old information has now been ported over. Looking > > at the documentation Lighthouse project[1], it looks like all of the > > old "merge/update" tickets have been closed (yay!), which may mean > > exactly that, someone from the docs team can presumably confirm that. > > > > Once we're ready, 301s that live in those locations for a long, long > > time are indeed appropriate. Or if 301s are hard in Mephisto, > > replacing each of the API documentation articles with a link to the > > new one. > > > > [1] > https://prototype.lighthouseapp.com/projects/42103-prototype-document... > > > > -- T.J. > > > > On Apr 5, 3:30 pm, Mislav Marohnić <mislav.maroh...@gmail.com> wrote: > > > > > > > > > On Mon, Apr 5, 2010 at 11:48, Johan Arensman <johanm...@gmail.com> > wrote: > > > > Wow! I didn't even realise they were updated until I read this > message. > > > > Very nice work indeed! > > > > > My coworkers still find old docs (http://prototypejs.org/api) by > googling. I > > > had to point them to new doc site. I think it's crucial to set up 301 > > > redirects. > > -- > You received this message because you are subscribed to the Google Groups > "Prototype: Core" group. > To post to this group, send email to prototype-core@googlegroups.com > To unsubscribe from this group, send email to > prototype-core-unsubscr...@googlegroups.com > For more options, visit this group at > http://groups.google.com/group/prototype-core?hl=en > > To unsubscribe, reply using "remove me" as the subject. > -- You received this message because you are subscribed to the Google Groups "Prototype: Core" group. To post to this group, send email to prototype-core@googlegroups.com To unsubscribe from this group, send email to prototype-core-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/prototype-core?hl=en
