• Do not register here on develop.twiki.org, login with your twiki.org account.
• Use View topic Item7848 for generic doc work for TWiki-6.1.1. Use View topic Item7851 for doc work on extensions that are not part of a release. More... Close
• Anything you create or change in standard webs (Main, TWiki, Sandbox etc) will be automatically reverted on every SVN update.
Does this site look broken?. Use the LitterTray web for test cases.

  1. The table of contents in TWikiDocumentation.html contains absolute links to twiki.org instead of mere "#label" references. Highly misleading, since it points to Cairo information if inadvertedly clicked upon.
  2. DakarReleaseNotes.html contains absolute links to twiki.org for the contributors (which is ok), but broken absolute links to scobydoo/CLEAN in the table of contents.


This is essentially the same two problems that I reported in Item692 which was subsequently closed because SD claimed not to be able to reproduce them. They are bloody easy to reproduce - just open up TWikiDocumenation and click on a toc link.

I think that the root level TWikiDocumenation.html file in inherently broken, at lease the way it is currently being created. As currently implemented, it is guaranteed to give new users a completely frustrating initial experience of TWiki! In addition to the TOC being broken, all the absolute links to TWiki.org are likely to be the wrong version of documentation (Cairo vs Dakar). If this isn't a formula for frustation, I don't know what is.

The problem with the toc is fairly simply solved manually (with a search and replace) but I don't know if this is viable if the builds are automated. The other problem seems more intractable. Although this is a departure from the Cairo model, I would *highly recommend we drop this file from the distribution and provide just the installation instructions and links to the appropriate set of complete documentation on TWiki.org. Feedback?

I'm raising this bug to urgent because I can't see inflicting this file on new users in its current form.

LB

(1) SVN 7896

(2) I can't find any absolute links to scoobydoo/CLEAN in the TOC. There are links in the content, because there are examples in the text that have to be expanded to point somwhere. I fixed them all to point at twiki.org. SVN 7895

CC

ItemTemplate
Summary Beta5: HTML documentation in base directory has wrong absolute links
ReportedBy TWiki:Main.HaraldJoerg
Codebase

SVN Range 7873
AppliesTo Engine
Component BuildScripts
Priority Urgent
CurrentState Closed
WaitingFor

Checkins 7895 7896
Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View |  Raw edit | More topic actions
Topic revision: r5 - 2005-12-22 - CrawfordCurrie
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback