You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@isis.apache.org by "Daniel Keir Haywood (Jira)" <ji...@apache.org> on 2021/02/04 07:04:00 UTC
[jira] [Commented] (ISIS-2526) Tooling: suppress header, use
filename in caption
[ https://issues.apache.org/jira/browse/ISIS-2526?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17278601#comment-17278601 ]
Daniel Keir Haywood commented on ISIS-2526:
-------------------------------------------
[~hobrom] - this one is worth doing for M5, I think (it's trivial to do, I am sure).
> 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
> Priority: Major
> 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)