Documentation link is README is broken about capistrano HOT 20 CLOSED

Thank you, another, another report - someone moved the wiki page, and broke
links all over the internet to the documentation - I will move it back.

On 12 July 2011 02:08, robolson <
[email protected]>wrote:

The link in the readme points to
http://github.com/capistrano/capistrano/wiki/Documentation-v2.x which does
not exist. I am not sure if that page used to exist and it was deleted or if
this link has always been wrong.

I suspect that, instead, it should point to
https://github.com/capistrano/capistrano/wiki

Reply to this email directly or view it on GitHub:
#67

from capistrano.

Resolved (a few days ago, actually - sorry for forgetting to close the issue.)

from capistrano.

@leehambley, looks like this issue is back - Do you think it's best to point the "main site" at a movable wiki page? Might cut back on a lot of IRC/"Bug" noise to just link capistranorb to the wiki home, or the codebase itself.

-torrancew

from capistrano.

@torrancew The documentation could also link at capistranorb.com - which is the link I use for most things ( just for that reason that people keep moving the wiki around)

from capistrano.

Wow, now I see what you mean, someone moved the wiki page.

from capistrano.

So someone called @paulsschwarz deleted it 20 days ago. (/cc @paulsschwarz why did you feel the need to remove it, can it be brought back, should it be brought back, after feeling strongly enough to make edits, i'd appreciate your input)

from capistrano.

I had no idea that I had! Why I'd have permissions to delete someone else's file, I'm not sure. Hope it can be resolved?

from capistrano.

It's not a file Paul it's from the wiki, I guess you were working / reading in there. I don't know how challenging the UI is for deleting a wiki page, but here's what I just tweeted https://twitter.com/codebeaker/status/222583092236390400 - I do think this is a fairly major flaw in the GitHub wiki system.

from capistrano.

Looking at the wiki pages again now I'm seeing that at the bottom of every page there's a Delete link. When you click it I believe it doesn't even ask to confirm. However, when I was going through my own repo's admin area on GitHub I recall seeing permissions. There were two options: anyone can edit the wiki, or only people with push access to the repo can edit the wiki. Seems a little odd. Looking at the wiki history it seems everyone has had a go at deleting a page or two!

from capistrano.

@paulsschwarz good to know I can "lock" the wiki against people without commit access, but I think that will stifle contributions to the wiki, which I don't really want do to.

from capistrano.

Thanks for bringing the page back @paulsschwarz

from capistrano.

If/when I have the time for this (being that I am resigned from Capistrano until mid/late September) - I would go in this direction. https://groups.google.com/forum/?fromgroups#!topic/github/ywPIBWwg1Y0

from capistrano.

Thanks a lot, @leehambley. Perhaps I can take a crack at creating a gh-pages site that has the same content and structure as the wiki in the mean time.

from capistrano.

@torrancew I'd love that actually, I had a WIP guide in my repository (and there's one on the Capistrano account too) - I always get hung up on a design (although bootstrap should fix that :-)) - happy to remote-pair with you on that, if we can.

from capistrano.

That sounds good @leehambley - Are you referring to the cap handbook? I'm a bit busy this week, but may be able to arrange some time on or after this weekend.

-Tray

from capistrano.

@torrancew There's the capistranorb.com repository that I started last ween on the capistrano account, and the handbook (which got a lot of good feedback) on my personal account.

I'm actually starting a week long vacation tomorrow afternoon, after that I'm away 50% of August (odd days here and there) - thus my shortness of time.

More than happy to do whatever I can - contact me and please don't be concerned if it takes me a day or two to come back to you.

from capistrano.

The "Getting Started" link on the Introduction and Explanation page was pointing to the nonexistant page https://github.com/capistrano/capistrano/wiki/getting-started. I updated it to to https://github.com/capistrano/capistrano/wiki/2.x-Getting-Started.

And today, 2.x-from-the-beginning was deleted. I restored 2.x-from-the-beginning based on a Google cached version. How can we prevent pages from being inappropriately deleted in the future?

As of today, the delete page link is rather small, at the bottom, and has a confirmation popup. So accidental deletion doesn't seem very likely. The collaborators of should restrict wiki edits to themselves since this seems to be happening more often than not.

from capistrano.

There may be a lot of inadvertent and purposeful vandals out there, but I see that most people commit useful documentation changes. Instead of updating from the Google cache as in @davidxia's case, how about maintaining a clone of the Capistrano wiki (which is a Git repository itself) if you are a frequent contributor? Besides being able to revert destructive changes, it would encourage more coherent sets of edits that you had to the chance to curate with --amend and rebase.

from capistrano.

@davidxia Please see https://groups.google.com/forum/?fromgroups#!topic/capistrano/TJmdOEXyy7Q%5B1-25%5D (posted a few minutes ago) - I believe the wiki format is the best, but I can't believe how many people keep deleting our homepage, Github's wiki feature needs more features for protecting pages I believe. That being said, they do provide GH-Pages, which is a fine solution. Please feedback on the mailing list, I don't believe this can be called an "open issue" anymore.

from capistrano.

Can I suggest that the problem here is that your home page is so small that
the Delete link is "above the fold" so it's visible and inviting to people
who "wonder what this does". Other pages are more lengthy and so you have
to scroll down before you see the delete link. You inadvertently created
the great "call to action" link! The marketing team would be proud. Try to
fill up the page a little more so the delete link becomes unnoticeable to
the casual visitor.

On 11 August 2012 16:52, Lee Hambley [email protected] wrote:

@davidxia https://github.com/davidxia Please see
https://groups.google.com/forum/?fromgroups#!topic/capistrano/TJmdOEXyy7Q%5B1-25%5D(posted a few minutes ago) - I believe the wiki format is the best, but I
can't believe how many people keep deleting our homepage, Github's wiki
feature needs more features for protecting pages I believe. That being
said, they do provide GH-Pages, which is a fine solution. Please feedback
on the mailing list, I don't believe this can be called an "open issue"
anymore.

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/67#issuecomment-7666915.

from capistrano.