breautek commented on issue #1279: URL: https://github.com/apache/cordova-docs/issues/1279#issuecomment-1364164865
>> If a link is specifically targeting an older version, then redirecting it to a different version is also not acceptable. > >Why is this not acceptable? Last time we attempted to remove large amount of pages that were obsolete were the translated documentation. They weren't kept up with the latest document and often had severely out-dated information. A lot of this documentation had no english counterpart either as the english documentation was removed. There was a lot of resistance simply redirecting to a 404 as can be seen in the original PR https://github.com/apache/cordova-docs/pull/1015 Ultimately that PR failed to got merged but a new PR was created to redirect when possible, and 404 otherwise and that was accepted. > But keep documentations from cli version 2.5.0 and older is hard to understand. Because i think you cannot any longer build a useful app with cli version 2.5.0. To be clear, I understand and yes keeping those documentation around today is probably nearly pointless. Personally I actually agree. I'm just simply stating that we've had resistance before when mass removing documentation. At the very least, I think we need to make a [Dev Mailing List](https://cordova.apache.org/contact/) to announce intent to remove old documentation, which versions should be removed, and see if the community today agrees with the that motion. However, if we jump back to the original issue: > When I want to search for the plugin "cordova-plugin-local-notifications" with the keywords "cordova plugin notifications", I get a outdated documentation for the cordova-plugin-dialogs plugin for the cli version 2.5.0 as result. I'm not certain that removing or applying the `noindex` rule on old documentation pages will ultimately solve that problem. Like I mentioned before, dialogs and local notifications are similar, and dialogs uses the term `notification` quite frequently as it's part of it's API namespace, which is likely why google brings up that page as a relevant search result, even though they are two completely separate things and don't address the same problem. So even if we applied the changes discussed, I would expect that Google and other search engines will start showing a page like https://cordova.apache.org/docs/en/11.x/reference/cordova-plugin-dialogs/index.html in place of an older version, which doesn't necessarily solve the original problem, and to be frank, I don't think that's a problem we can solve. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
