[xwiki-users] Questions about the New Syntax help; was: Re: Link with get parameters and ID in XWiki 2.0 syntax

On 09/17/2013 05:18 PM, Vincent Massol wrote: Well, I looked into it and already have a few questions. sorry ... WCAG Validation: Where is the WCAG test which makes the build fail? When I just run a mvn install inside the xwiki-platform-help-ui itself, this works. Do I have to make a full build to get the test running that would break now? Aside of that I have problems getting WCAG validity anyway. I tried the recommended online validation tool at http://www.webrichtlijnen.nl/english/testing but that complains that the page uses <tt>, and has several <h1> header ... well, they are part of the documentation showing how to type monospace and headers, so it is hard to avoid them except by leaving the out, which is kinda silly for a documentation; also they are already in the existing syntax help page, so it seems there is some way to avoid that which I do not know. Additionally there are a lot of duplicate id="H2.0" or the like in the full page, but this is how the proper syntax version is extracted from the document containing the relevant section. Similar to Johannes I am a bit lost how to avoid that, except for doing odd things like scrapping the header after rendering, or split the documentation into one document per section *and* syntax (would end up with somewhat 40 instead of 20 headers), or add separate "marker heading" to each and every section (the latter the somewhat best option imo) I see also some problem has been point out that the tables having width=100% However this is also the case with the existing syntax help; but for me they do more harm (making the tables with the examples shift below the left navigation), so I prefer scrap them all unless someone can tell me why they are there in the first place. Translations: There are a few new translations keys. Can I just add them to the ApplicationResources.properties? Additionally there are some existing translations of the complete document: http://l10n.xwiki.org/xwiki/bin/view/L10N/Search?application=&name=Plat… How is it possible to split the content into documents and still make then show up on l10n? (I hope I can do the split in the *.xml files, even though I do not understand most languages, as I can go by the examples, but I have no idea how to sync the results with l10n.xwiki,org.) Finally, should I discuss these issues here in the list, or in jira or on the devs list instead? Any pointers would be very appreciated. Clemens