Roundup Tracker - Issues

Issue 2550786

classification
Title: Dead link to philosophy and rationale in Introduction in the documentation
Type: crash Severity: normal
Components: Documentation Versions: 1.4
process
Status: new Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: atsaloli, ber, jonct, rouilj, schlatterbeck
Priority: Keywords:

Created on 2013-01-01 02:52 by atsaloli, last changed 2013-01-07 22:12 by rouilj.

Messages
msg4704 Author: [hidden] (atsaloli) Date: 2013-01-01 02:52
Hi.  I'm just trying out Roundup.  In the Introduction section at
http://www.roundup-tracker.org/docs/design.html#introduction, I read:

        For the philosophy and rationale behind the Roundup design, 
        see the first-round Software Carpentry submission for Roundup.

And there is a link to http://www.roundup-tracker.org/docs/spec.html
which is a dead link (404 Not Found).

Could you please fix the dead link?  I'd like to read this document.  

Best,
Aleksey
msg4705 Author: [hidden] (jonct) Date: 2013-01-01 06:38
Funny. I found I needed to go track this down just after you did, to quote a passage for my 
workgroup.

I suggest you start with <http://zesty.ca/roundup.html>. Then you can follow its links to the 
first and second round draft specs, which seem to me to be fairly well represented by the current 
design document. But this earlier document is the most concise description I've seen of what 
makes Roundup stand out as it does.
msg4706 Author: [hidden] (rouilj) Date: 2013-01-01 15:22
I am not sure where the document is on the roundup web site,
but I think this is the document it intended to link to:

  http://zesty.ca/sc-roundup.html

Also including a link to the short paper in the docs may not be a bad idea:

  http://zesty.ca/roundup.html
msg4732 Author: [hidden] (schlatterbeck) Date: 2013-01-07 19:26
Thanks to Jon and John for digging this up.
The document in question is actually checked in (as html) in the roundup
sources in doc/spec.html -- it is the Implementation Guide not the
overview document.

But it seems the current build process doesn't include it in the
generated HTML for the web-site.

You can get it directly from the repository:
http://roundup.hg.sourceforge.net/hgweb/roundup/roundup/file/ec359e7c6c95/doc/spec.html

It is linked from the site you mention at
http://zesty.ca/sc-roundup-2.html
msg4733 Author: [hidden] (atsaloli) Date: 2013-01-07 20:27
Thank you very much!  This was well received.

Aleksey
msg4734 Author: [hidden] (ber) Date: 2013-01-07 20:32
Okay, where should be link to from design.txt?
To http://zesty.ca/sc-roundup-2.html or to the hg or should be include
the html in the output?
msg4735 Author: [hidden] (atsaloli) Date: 2013-01-07 20:36
Dear Ralf,

  Actually, the document I was looking for *is* the Overview document,
not the Implementation Guide.   Specifically,
http://zesty.ca/sc-roundup.html

  Thank you again.   Somebody might want to fix the website - as I
wrote when I opened this issue, there is a dead link to this important
document.

Best,
-at

On Mon, Jan 7, 2013 at 11:27 AM, Ralf Schlatterbeck
<issues@roundup-tracker.org> wrote:
>
> Ralf Schlatterbeck added the comment:
>
> Thanks to Jon and John for digging this up.
> The document in question is actually checked in (as html) in the roundup
> sources in doc/spec.html -- it is the Implementation Guide not the
> overview document.
>
> But it seems the current build process doesn't include it in the
> generated HTML for the web-site.
>
> You can get it directly from the repository:
> http://roundup.hg.sourceforge.net/hgweb/roundup/roundup/file/ec359e7c6c95/doc/spec.html
>
> It is linked from the site you mention at
> http://zesty.ca/sc-roundup-2.html
>
> ----------
> nosy: +schlatterbeck
>
> ________________________________________________
> Roundup tracker <issues@roundup-tracker.org>
> <http://issues.roundup-tracker.org/issue2550786>
> ________________________________________________
msg4737 Author: [hidden] (atsaloli) Date: 2013-01-07 20:46
Hi, Bernhard.  I would suggest linking to the original document
(http://zesty.ca/sc-roundup.html).  It gives really concise overview
of what Roundup is intended to be.

Best,
Aleksey
msg4738 Author: [hidden] (rouilj) Date: 2013-01-07 22:12
In message <CA+PPeYao1UgrZzJtoCWcO8wPC9qhtzaFENaetAmmXUcYYXpC7A@mail.gmail.com>
 <CA+PPeYao1UgrZzJtoCWcO8wPC9qhtzaFENaetAmmXUcYYXpC7A@mail.gmail.com>,
Aleksey Tsalolikhin writes:
>Aleksey Tsalolikhin added the comment:
>
>Hi, Bernhard.  I would suggest linking to the original document
>(http://zesty.ca/sc-roundup.html).  It gives really concise overview
>of what Roundup is intended to be.

As much as I hate to say it (because linking site to site is the way
of the web), I think a copy of this page should be made locally on the
roundup-tracker.org website and pushed as part of the website.

I think this document is valuable enough that we don't want to chance
losing it if the zesty.ca website goes away. So if it and its images
are in hg already we should check it out into the web site and link to
the checked out copy, if it's not in hg it should get there.
History
Date User Action Args
2013-01-07 22:12:25rouiljsetmessages: + msg4738
2013-01-07 20:46:26atsalolisetmessages: + msg4737
2013-01-07 20:36:56atsalolisetmessages: + msg4735
2013-01-07 20:32:53bersetmessages: + msg4734
2013-01-07 20:27:07atsalolisetmessages: + msg4733
2013-01-07 19:27:00schlatterbecksetnosy: + schlatterbeck
messages: + msg4732
2013-01-02 11:07:59bersetnosy: + ber
2013-01-01 15:22:00rouiljsetnosy: + rouilj
messages: + msg4706
2013-01-01 06:38:52jonctsetnosy: + jonct
messages: + msg4705
2013-01-01 02:52:13atsalolicreate