Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

wiki: rename FileTreeDocumentation #34940

Closed
ghost opened this issue Oct 16, 2019 · 6 comments
Closed

wiki: rename FileTreeDocumentation #34940

ghost opened this issue Oct 16, 2019 · 6 comments
Labels
Documentation FrozenDueToAge NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made.

Comments

@ghost
Copy link

ghost commented Oct 16, 2019

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

In alternative the name might simply be shortened to FileTree.

@julieqiu
Copy link
Member

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

@julieqiu julieqiu added the WaitingForInfo Issue is not actionable because of missing required information, which needs to be provided. label Oct 18, 2019
@ghost
Copy link
Author

ghost commented Oct 18, 2019

@ALTree
Copy link
Member

ALTree commented Nov 3, 2019

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.

@ALTree ALTree added NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. and removed WaitingForInfo Issue is not actionable because of missing required information, which needs to be provided. labels Nov 3, 2019
@ghost
Copy link
Author

ghost commented Nov 3, 2019

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
Copy link
Member

ALTree commented Nov 4, 2019

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
Copy link
Author

ghost commented Nov 6, 2019

move

my preference is for a move to GoTree

factually, that's what the text is describing

@ghost ghost closed this as completed Feb 9, 2020
@golang golang locked and limited conversation to collaborators Feb 8, 2021
This issue was closed.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Documentation FrozenDueToAge NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made.
Projects
None yet
Development

No branches or pull requests

3 participants