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, techtonik
Priority: Keywords:

Created on 2013-01-01 02:52 by atsaloli, last changed 2014-12-16 15:25 by techtonik.

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.
msg5172 Author: [hidden] (techtonik) Date: 2014-12-13 17:34
http://zesty.ca/ is gone.

The archive is still there, but some spam/squatters may take control over 
it soon. http://web.archive.org/web/20141119012911/http://zesty.ca/
msg5174 Author: [hidden] (schlatterbeck) Date: 2014-12-15 09:12
On Sat, Dec 13, 2014 at 05:34:03PM +0000, anatoly techtonik wrote:
> 
> http://zesty.ca/ is gone.
> 
> The archive is still there, but some spam/squatters may take control over 
> it soon. http://web.archive.org/web/20141119012911/http://zesty.ca/

Hmm, whois isn't really clear who is the current registrar:
Domain status:         auto-renew grace
Creation date:         2001/11/02
Expiry date:           2015/11/01
Updated date:          2014/11/24
(but no registrar info)

maybe just a server failure or a failure to renew in time?

I've secured copies from archive.org including the pictures.
Maybe we should start a "history" section in our documentation, provided
the site doesn't come back and we're able to get permission...

Ralf
msg5175 Author: [hidden] (techtonik) Date: 2014-12-16 15:25
On Mon, Dec 15, 2014 at 12:12 PM, Ralf Schlatterbeck
<issues@roundup-tracker.org> wrote:
>
> Maybe we should start a "history" section in our documentation, provided
> the site doesn't come back and we're able to get permission...

html_extra/ is there exactly for this purpose. It only needs some
index page with explanations, because right now the amount of docs on
Roundup architecture is pretty confusing. I don't know which I want to
read first, so it would be nice to lay them out at least by time. Of
course it is better with a short comparison documenting changes from
one doc to other over time.
History
Date User Action Args
2014-12-16 15:25:37techtoniksetmessages: + msg5175
2014-12-15 09:12:16schlatterbecksetmessages: + msg5174
2014-12-13 17:34:03techtoniksetnosy: + techtonik
messages: + msg5172
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