Re: [xwiki-devs] [Proposal] Release Notes Application

[snip] This is what I was saying above ;) Except that it’s not so easy and is a much bigger scope. What I propose is to start with the Release Notes application, and as data fills up, we can start experimenting with using it to generate reference documentation. I think the main issue we’ll have is that adding up changes doesn't generate good documentation. It only generates a randomly-ordered list of features with no narrative. In any case if we think it has value, we’ll be able to use it (and even possibly refactor the Release Notes app and extract a Features app from it). But let’s take it one step at a time! This is actually the same for both. They both present by category and version. For the reference documentation we use “Since XWiki N.NN” for the version info). I’ve refactored the app I started to support multiple displayer. I now have Grid + Flow. You choose the displayer as a macro parameter: {{changes … displayer=“flow” …/}} {{changes … displayer=“grid” …/}} Don’t forget that currently our Release notes don’t present just Features (what I call Changes). They also present updated libs, tested stuff, translations, backward compat, etc). So in order to have a top nav as on the link you gave above, you’ll need to refactor the RN page and probably extract out the Changes part from it. Now I agree that for a user the main info are the Changes and we could change the design of our RN and focus on Changes and have a “Advanced” section at the end with the rest. This is where we’d need your help :) Yes, don’t worry you’ll have plenty of work to make it nice-looking ;) I’d really like to force having always screenshots for user-related changes. Anything too small to not have a screenshot is a misc for me. And I think we should do that since it would help us make sure that we always have screenshots for user-related changes. I don’t see how hard it is to add just a few words describing the screenshot. Note that since the screenshots are metadata if you want a report showing only screenshots that’s easy to do. Following Marius’s comment, I’ve added an “Importance” xproperty to the app (with 3 levels; High, Medium, Low). We’ll see how it goes. Yes and I’m not even sure it’s a good thing since JIRA is a tool to help development (the importance of an issue in jira doesn’t correspond to the importance a feature has for users). Thanks -Vincent