Roundup Tracker - Issues

Issue 2550859

classification
spec.html 404
Type: Severity: normal
Components: Documentation Versions:
process
Status: closed duplicate
: Broken link in docs: spec.html 404
View: 2550840
: rouilj : jerrykan, rouilj, techtonik, westurner
Priority: normal :

Created on 2014-12-07 02:13 by westurner, last changed 2014-12-13 12:19 by techtonik.

Files
File name Uploaded Description Edit Remove
unnamed westurner, 2014-12-08 00:36
Messages
msg5158 Author: [hidden] (westurner) Date: 2014-12-07 02:13
http://www.roundup-tracker.org/docs/developers.html#getting-started

"Anyone wishing to help in the development of Roundup must read **Roundup’s Design 
Document** and the implementation notes." > http://www.roundup-tracker.org/docs/spec.html 
[404]
msg5159 Author: [hidden] (rouilj) Date: 2014-12-07 04:26
Tracked this down in the repo in the doc directory.

There does not appear to be a spec.txt, nor the image
files it needs in the current head.

I changed the spec.html references to design.html and changed the
spec.html reference in installation.txt to point to design.html as
well.

design.txt's reference to spec.html still exists. I was able to find
what I think is spec.html from google cache. Details in the check-in
message below. However I am not sure how to update the web site to
get my changed .txt files. I am not sure how to (or if I should)
integrate the spec.html I downloaded into the roundup web site.

I pushed my changes to ssh://hg.code.sf.net/p/roundup/code

check-in note:

changeset:   4948:4a3a35192ad1
tag:         tip
parent:      4945:55aef7ab35a8
user:        John Rouillard <rouilj at ...>
date:        Sat Dec 06 23:18:40 2014 -0500
files:       doc/developers.txt doc/installation.txt doc/spec.html
description:
Fixing http://issues.roundup-tracker.org/issue2550859 which reports a
404 error accessing spec.html reference in the developer.html page.

Changed references to spec.html in developers.txt and installation.txt
to point to design.html since there is no spec.html.

I did track down a copy of what I think is supposed to be spec.html
from google cache of:

 http://zesty.ca/sc-roundup.html. It is a snapshot of the page as it
 appeared on Dec 4, 2014 22:56:45 GMT

obtained via:

http://webcache.googleusercontent.com/search?q=cache:Zyw8ZjphH2AJ:zesty.ca/sc-roundup.html

The copy of spec.html is missing images (www.lfw.org which hosted the
images seems to be gone).

I left the reference to spec.html in design.txt (aka design.html)
rather than having it point to itself. Also the text surrounding the
reference to spec.html discussses rationale and things that are
misssing from design.html.

I am not sure what can be done to retrieve the real spec.html with
images etc, or exactly how to handle the spec.html reference in
design.html.
msg5160 Author: [hidden] (westurner) Date: 2014-12-08 00:36
Thanks!

On Sat, Dec 6, 2014 at 10:26 PM, John Rouillard <issues@roundup-tracker.org>
wrote:

>
> John Rouillard added the comment:
>
> Tracked this down in the repo in the doc directory.
>
> There does not appear to be a spec.txt, nor the image
> files it needs in the current head.
>
> I changed the spec.html references to design.html and changed the
> spec.html reference in installation.txt to point to design.html as
> well.
>
> design.txt's reference to spec.html still exists. I was able to find
> what I think is spec.html from google cache. Details in the check-in
> message below. However I am not sure how to update the web site to
> get my changed .txt files. I am not sure how to (or if I should)
> integrate the spec.html I downloaded into the roundup web site.
>
> I pushed my changes to ssh://hg.code.sf.net/p/roundup/code
>
> check-in note:
>
> changeset:   4948:4a3a35192ad1
> tag:         tip
> parent:      4945:55aef7ab35a8
> user:        John Rouillard <rouilj at ...>
> date:        Sat Dec 06 23:18:40 2014 -0500
> files:       doc/developers.txt doc/installation.txt doc/spec.html
> description:
> Fixing http://issues.roundup-tracker.org/issue2550859 which reports a
> 404 error accessing spec.html reference in the developer.html page.
>
> Changed references to spec.html in developers.txt and installation.txt
> to point to design.html since there is no spec.html.
>
> I did track down a copy of what I think is supposed to be spec.html
> from google cache of:
>
>  http://zesty.ca/sc-roundup.html. It is a snapshot of the page as it
>  appeared on Dec 4, 2014 22:56:45 GMT
>
> obtained via:
>
>
> http://webcache.googleusercontent.com/search?q=cache:Zyw8ZjphH2AJ:zesty.ca/sc-roundup.html
>
> The copy of spec.html is missing images (www.lfw.org which hosted the
> images seems to be gone).
>
> I left the reference to spec.html in design.txt (aka design.html)
> rather than having it point to itself. Also the text surrounding the
> reference to spec.html discussses rationale and things that are
> misssing from design.html.
>
> I am not sure what can be done to retrieve the real spec.html with
> images etc, or exactly how to handle the spec.html reference in
> design.html.
>
> ----------
> nosy: +rouilj
> priority:  -> normal
> status: new -> open
>
> ________________________________________________
> Roundup tracker <issues@roundup-tracker.org>
> <http://issues.roundup-tracker.org/issue2550859>
> ________________________________________________
>
msg5161 Author: [hidden] (jerrykan) Date: 2014-12-08 00:58
Is this related to issue2550840 ?

If so it may just be the case that the website has not been updated
since the other fix was committed.
msg5162 Author: [hidden] (rouilj) Date: 2014-12-08 01:20
Jerrykan, yes I think you are right.

I backedout and pushed a new update upstream to remove my changes.

I am not sure how to update the web site. I am going to mark this as 
a duplicate and set the superseder file to the original issue.

===
changeset:   4949:c3a90535f7a7
tag:         tip
user:        John Rouillard <rouilj@ieee.org>
date:        Sun Dec 07 20:15:45 2014 -0500
files:       doc/developers.txt doc/installation.txt doc/spec.html
description:
Backed out changeset 4a3a35192ad1
msg5163 Author: [hidden] (techtonik) Date: 2014-12-13 10:08
> I am not sure how to update the web site.

The process is described in website/README.txt

See here
http://sourceforge.net/p/roundup/code/ci/default/tree/website/
Or here
https://bitbucket.org/roundup/roundup/src/tip/website/?at=default
msg5168 Author: [hidden] (techtonik) Date: 2014-12-13 12:18
Updating site won't help, because conf.py is different for the web-site.
msg5169 Author: [hidden] (techtonik) Date: 2014-12-13 12:19
See issue2550840 for the heads up.
History
Date User Action Args
2014-12-13 12:19:13techtoniksetmessages: + msg5169
2014-12-13 12:18:34techtoniksetmessages: + msg5168
2014-12-13 10:08:27techtoniksetnosy: + techtonik
messages: + msg5163
2014-12-08 01:20:33rouiljsetstatus: open -> closed
assignee: rouilj
superseder: Broken link in docs: spec.html 404
messages: + msg5162
resolution: duplicate
2014-12-08 00:58:05jerrykansetnosy: + jerrykan
messages: + msg5161
2014-12-08 00:36:16westurnersetfiles: + unnamed
messages: + msg5160
2014-12-07 04:26:56rouiljsetstatus: new -> open
priority: normal
messages: + msg5159
nosy: + rouilj
2014-12-07 02:13:30westurnercreate