Bug 325409 - Kate "get-it" page has broken link (404) to Kate git repo
Summary: Kate "get-it" page has broken link (404) to Kate git repo
Status: RESOLVED FIXED
Alias: None
Product: kate
Classification: Applications
Component: general (show other bugs)
Version: unspecified
Platform: unspecified Unspecified
: NOR normal
Target Milestone: ---
Assignee: KWrite Developers
URL: http://kate-editor.org/get-it/
Keywords:
Depends on:
Blocks:
 
Reported: 2013-09-29 02:59 UTC by steveL
Modified: 2013-10-07 07:32 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In:
Sentry Crash Report:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description steveL 2013-09-29 02:59:25 UTC
Where it says "Right now, Kate’s source code is located on git.kde.org." the old URL used:
https://projects.kde.org/projects/kde/kde-baseapps/kate  is incorrect.
It needs to be changed to:
https://projects.kde.org/projects/kde/applications/kate/repository
The actual git url in the sample shell session, is fine.

This matters because the main page for new Kate developers:
http://kate-editor.org/join-us/
links to the "get-it" page and the first thing people try to do is review what's already going on, via the link given. 404 just leaves a bad impression, and stops newbies from seeing what's going on easily. (There's a psychological barrier to going and cloning a git repo in a terminal session, that isn't there with clicking a link on a webpage.)

I have seen this myself several times in #kate, and from my own experience: it took a bit of perseverance to find the correct link, but it is so much more useful, especially with newcomers to the channel, who express interest in hacking.

Along the same lines, it would be useful if we could have that link in the /topic for the IRC channel: it makes all the difference in terms of collaboration around the codebase, as I have seen in other project channels. I've mentioned it a few times, and no one seems to have permission to change the /topic. Or at least, if they do, they're keeping quiet about it, and in the meantime the opportunity to recruit new people is hampered by clearly unintentional lack of transparency.

No I don't think it's the end of the world either ;) but it's really annoying to have to go and dig out the correct link for people, instead of just being able to give them the get-it link on its own, and let them explore the code themselves.

Or even better, having the repo web url in /topic as something we're _proud_ of, that they can click on as soon as they /join, and get started sooner.

Reproducible: Always




None of the above should be misconstrued as an attack on anybody; managing an IRC channel and programming an editor are very different skill-sets. And I'm grateful that kate is progressing so well.
Comment 1 T.C. Hollingsworth 2013-09-29 06:12:54 UTC
I fixed the kate-editor.org/get-it link.  Sorry about that, kde-baseapps was recently reorganized and that invalidated all of our documentation and gitweb links.  :-(

You might want to ping kwrite-devel@kde.org (or just ask on IRC ;-) about changing the IRC /topic, bugzilla's not really the right place to talk about that kind of thing.

Let me know if you have any other suggestions for improving our build documentation, or any other part of the documentation, for that matter.  Thanks!
Comment 2 steveL 2013-10-07 07:32:14 UTC
(In reply to comment #1)
> I fixed the kate-editor.org/get-it link.  Sorry about that, kde-baseapps was
> recently reorganized and that invalidated all of our documentation and
> gitweb links.  :-(

Thanks; that's perfect :-) It works nicely now.

> You might want to ping kwrite-devel@kde.org (or just ask on IRC ;-) about
> changing the IRC /topic, bugzilla's not really the right place to talk about
> that kind of thing.

Yeah, I've mentioned it on IRC a few times over last year or two ;-) No worries, it's not the main issue, which is fixed. (I'm igli on freenode, btw, if you are about in #kate.)

> Let me know if you have any other suggestions for improving our build
> documentation, or any other part of the documentation, for that matter. 
> Thanks!

Will do: thanks for quick response and fix.