Duplicated, outdated tutorial
UgmaDevelopment opened this issue · 5 comments
Hello!
I was following the tutorial at https://spring.io/guides/tutorials/bookmarks/ about Rest Services, when I came to a section that wouldn't compile for me.
Upon a little googling StackOverflow told me that Resource had been renamed EntityModel, but more importantly, in the comments, I spied another URL (https://spring.io/guides/tutorials/rest/) for this same "Building REST services with Spring" tutorial on spring's website.
It appears that the tutorial I was originally reading is an old version of the tutorial that contains multiple mistakes and the aforementioned stumbling block.
I bring this up so that this duplicate tutorial (https://spring.io/guides/tutorials/bookmarks/) can be taken down and all links referring to it can be changed to refer to the updated tutorial (https://spring.io/guides/tutorials/rest/).
What can I do to help in this endeavor?
spring.io delegates to github. Hence, https://spring.io/guides/tutorials/bookmarks/ translates to github.com/spring-guides/tut-bookmark, and /guides/tutorials/rest -> /spring-guides/tut-rest.
Since tut-bookmark was simply moved to tut-rest, github put a redirect in place, which we have no control over.
Since we can't really do anything about this, I'm closing this issue.
@gregturn, if GitHub was redirecting to the new tutorial, that would be fine; then it wouldn't have any of the mistakes I was talking about.
However, it doesn't appear to be doing that; it appears to be pointing to an old version of the tutorial that has the mistakes and which goes un-updated.
If https://github.com/spring-guides/tut-bookmark doesn't exist anymore how can it be showing that old content? If Github was redirecting, it would show the new content, right? To me it seems like there's a rendered file of the bookmark tutorial that needs to be gotten rid of or turned into a redirect.
It's https://github.com/spring-guides/tut-bookmarks.
When you rename a repository, github puts in the redirect. And I found, spring.io works PERFECTLY with that. Or rather...IM-perfectly.
Join me on https://gitter.im/spring-projects/spring-hateoas and we can discuss this more interactively.