react-redux-form icon indicating copy to clipboard operation
react-redux-form copied to clipboard

Old Documentation Not Marked As Old

Open zjr opened this issue 7 years ago • 6 comments

The Problem

There are old docs for this package up on gitbooks.io. There is no notice that the docs are outdated. That has the potential to be rather confusing.

Steps to Reproduce

Visit https://davidkpiano.gitbooks.io/react-redux-form/.

Expected Behavior

Something is written on these old docs to let people know that these docs are old, point to new docs.

Actual Behavior

Someone finds your old docs through some random post on Twitter somewhere, has no reason to expect that they are outdated, as is highly confused when things don't work right. Maybe they actually think they accidentally got an old version of the package. Perhaps something in their minds is going "hmm these docs look pretty well maintained, no need to look at the GitHub README about this…," and they would be wrong.

Reproducible Code Example

N/A

zjr avatar Feb 23 '18 22:02 zjr

If you can mark the old docs as outdated in a PR (or remove them), that would be greatly appreciated.

davidkpiano avatar Feb 23 '18 22:02 davidkpiano

I don't have a clue about gitbooks.io. That's connected to your repository somewhere? If so, sure, but not what I was expecting.

zjr avatar Feb 23 '18 22:02 zjr

Hah, when I try to visit http://gitbooks.io I get a 502 error. Are they not running anymore? Do they only have subdomains?

zjr avatar Feb 23 '18 22:02 zjr

@zjr It would be on the gh-pages branch.

davidkpiano avatar Feb 24 '18 06:02 davidkpiano

@davidkpiano I think you might be misunderstanding me. This isn't a problem with your current documentation on GitHub Pages. I did in fact check this branch you mentioned… as one would suspect given the branch's name: this is code for GH Pages.

The problem is that you have old docs sitting up on http://gitbooks.com. This is books not pages. I don't have any idea how I would change what you have on GitBooks. This isn't like updating a README.md for you or something, this appears to be a whole other thing outside of GitHub.

zjr avatar Feb 24 '18 14:02 zjr

When I say old I mean like… these docs are very different from the way your package currently works, they seem to be quite old.

zjr avatar Feb 24 '18 14:02 zjr