[jira] [Created] (ISIS-2526) Tooling: suppress header, use filename in caption

["Daniel Keir Haywood (Jira)" <ji...@apache.org>]

Daniel Keir Haywood created ISIS-2526:
-----------------------------------------

             Summary: Tooling: suppress header, use filename in caption
                 Key: ISIS-2526
                 URL: https://issues.apache.org/jira/browse/ISIS-2526
             Project: Isis
          Issue Type: Improvement
          Components: Isis Docs & Website
            Reporter: Daniel Keir Haywood
             Fix For: 2.0.0-M5
         Attachments: image-2021-02-04-06-59-18-608.png, image-2021-02-04-06-59-48-038.png

The generated index includes a header, but that makes it tricky to include.  

For example, this source:

!image-2021-02-04-06-59-48-038.png|width=533,height=113!

 

Renders as folows:

!image-2021-02-04-06-59-18-608.png|width=327,height=165!

 

I think that the "AcceptHeaderService : interface" is unnecessary (there would normally be a paragraph here anyway if there was some javadoc for the class).

It would be nice though to use the class as a caption:
{code:java}
[source,java]
.AcceptHeaderService.java
----
public interface  AcceptHeaderService {
   ...
}
----{code}
 



--
This message was sent by Atlassian Jira
(v8.3.4#803005)