[hibernate-dev] Publishing documentation as rendered by asciidoc

[Hardy Ferentschik]

On 9 Jan 2014, at 13:01, Sanne Grinovero <sanne at hibernate.org> wrote:

> hi Guillaume, great progress!
> In Google's Chrome it looks almost ok, not quite as the headers we
> have on the docs published at [1] but I guess you can easily fix that.
> On Firefox, it looks odd. There is something being repeated all over
> along the whole document.. I hope you can see the same, or let me know
> if I should send you a screenshot?

For what it's worth, I can confirm this repetition of the background Sanne
describes.

On a tangent and related to style fixes. Not sure whether other projects already use Java 8 for
building, but there are yet again changes to the javadoc doclet output leading to
badly rendered output. We have this problem with Validator's docs [1] and there is a related
design issue [2]. I am wondering whether the design team could help to make sure that the
L&F of reference and java docs are matching. That said, afaict the issue has quite low priority for
them :-(

--Hardy


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 496 bytes
Desc: Message signed with OpenPGP using GPGMail
Url : http://lists.jboss.org/pipermail/hibernate-dev/attachments/20141009/099a4523/attachment-0001.bin