golang / go

The Go programming language
https://go.dev
BSD 3-Clause "New" or "Revised" License
123.24k stars 17.57k forks source link

wiki: rename FileTreeDocumentation #34940

Closed ghost closed 4 years ago

ghost commented 4 years ago

I'd like to rename the FileTreeDocumentation page to GoTree.

In alternative the name might simply be shortened to FileTree.

julieqiu commented 4 years ago

@apparluk would you mind linking the page that you are referring to?

ghost commented 4 years ago

https://github.com/golang/go/wiki/FileTreeDocumentation

ALTree commented 4 years ago

I agree that in "FileTreeDocumentation" the "Documentation" part is redundant, but I wonder if this is important enough to change it.

Yes, we could avoid breaking links by keeping FileTreeDocumentation and redirecting to FileTree, but the redirect is "manual" (you have to change the page to say "See FileTree", and the user has to click on the link), so they're not a great user experience. Moreover, the old page remains in the list of wiki pages, so when you search "FileTree" you'll see both (and one is just an empty redirect); so the old "redirected" pages somewhat pollute the wiki.

If there was a way to 1) make the redirect automatic 2) hide the empty redirect-pages from the pages list, then it would be much less painful to rename pages at will to fix bad names; but since you cannot do that, we should only rename when absolutely necessary.

ghost commented 4 years ago

Factually, I don't know whether the page has ever received much traction.

Would you have an opinion on pasting it's contents into a new "GoTree" page, then simply deleting "FileTreeDocumentation"?

ALTree commented 4 years ago

the page has ever received much traction.

It probably hasn't, which would soften the impact of a page-move (not many links broken). OTOH, we usually try not to delete pages.

cc @andybons @dmitshur too for a decision regarding the page rename/move.

ghost commented 4 years ago

move

my preference is for a move to GoTree

factually, that's what the text is describing