On Mar 28, 2007, at 12:54 AM, Ludovic Dubost wrote: No... :-) I've already discussed this offline with Sergiu and he agreed with me. Here's why: - 1006 is about adding a macro like any other macro (toc, etc). It's to be used by users. It's an issue in the "Macro" component in JIRA. - The change is about modifying existing skin(s) to add a new feature, namely the support for footnotes. When users look at release notes they need to see what's new, what's modified and make an educated decision on whether they want to upgrade. Looking at the current releases notes in JIRA doesn't give a hint that the skins support footnotes now. It's a pity as it's a nice new feature we're adding... The JIRA strategy that we're following is that we need to make is user-oriented. It's for end users. It's not for us, we don't need it, we can look at commit messages to see what's being done, we can look at the source code, etc. JIRA issues are a communication channel with our users and as such they need to clearly show what's changed for them. They don't need (and shouldn't see) things like "remove $tdoc for permission improvement". This is not undestandable for a user. But something like "Allow setting permissions on translated version of documents" (this is a fake example just to make a point). Thanks -Vincent