Ross Gardler wrote: > David Crossley wrote: > >Ross Gardler wrote: > > ... > > >>1) revert the error handling which will give us meaningless locationmap > >>errors, but will give a meaningful broken-links.xml file > >> > >>2) Improve the generated error page to be more user friendly and show > >>the error in a graceful way, this will make the user experience better > >>if a broken site is deployed, but will make the admins job harder > >> > >>3) A mix of 1) and 2) in which we generate a nice user error page and we > >>use the SourceWritingTransformer to provide meaningful output for the > >>admin. > >> > >>4) ? > >> > >>Thoughts? > > > >Dunno. > > > >Better locationmap error messages are more important, > >because that can be complex to debug. > > As others have noted, I personally feel that broken-links.xml is more > important. The locationmap can be debugged if you know what you are > doing. So this will become a user support issue until we can patch the > locationmap (see my reply to Thorsten).
It frightens me that in such a small community we are creating a user support issue. The FAQ/Tutorial suggested below will be very important. > >Perhaps a way out for now is to describe the issue > >in Jira, add a note to the upgrading_08.html doc, and > >add to the end of the "site" ant target to scan the > >build directory to list any error_site_* files. > > > >That is not as good as the previous broken link handling > >because it doesn't list the referring pages. > > Which, for me is very important. Definitely. We would need to find another way to do it. > I've just commented out the relevant match in our root sitemap to > restore the old behaviour before the code freeze. I think we ought to > document the bad locationmap error message in the upgrading doc, along > with a hint on debugging via the locationmap logs (set the log level to > debug in logkit.xml), and a pointer to the mail lists for assistance. > (for now I've put a one line warning, better than nothing but needs > improving since reading the locationmap logs is not easy - I'm going to > bed now, sorry) Would someone who knows the locationmap please add a decent FAQ and a note to upgrading_08.html and a Jira Issue. > If someone manages to change the way the locationmap works and get it to > throw a proper error before the code freeze then we can reinstate the > error trapping. Otherwise we'll do it in the next release (which will > not be so long in the making - we can discuss that after the release). There is a bit under three days to go. -David