Hi,

I've spent some time updating the website:
- Migrating from fixed layout to a responsive design that adjusts to screen
size (mobilefriendlyness) while keeping the existing look&feel.
- Migrating to HTML5 including using CSS for design instead of hardcoding
in the "build system".
- Making sure all links are working

All pages now validate under https://validator.w3.org/ with one notable
exception:
Due to Ant/Velocity/Anakia being used as "build system" to generate the
HTML code, the "source files" must be valid XML. In XML, a self-closing tag
(ie, one that doesn't have a </end> tag) must be written as <xml />.
However in HTML, it must NOT be end with />. This causes problems for
guidelines.xml/html and versioning.xml/html. I don't see a way to fix this,
on the other hand I don't think any web browser wouldn't accept this. The
only other option would be to move away from Anakia completely: Subversion
is using Server side includes to bring in the common HTML fragments instead
of prebuilding complete HTML-files.

I personally found the "generate HTML" less intuitive than the SSI based
approach of Subversion. With the webpage now using CSS, there is less need
to have an XML transform adding different properties to all instances of
the same tag. But I don't want to rip out a whole build system with 20
years of history...

Speaking about Anakia and SSIs: I tried to be cleaver with the
/coverage/index.html file. It works fine as it is right now, but I can't
figure out a way to generate the <!--#include directive. Currently we have
to edit the index.html file manually before committing.

I've also updated the script generating the coverage report to work with
the above SSI changes.

If you find any issues, please report them here and I'll take a look!

Cheers,
Daniel

Reply via email to