accumulo-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Josh Elser (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (ACCUMULO-2394) Create release notes
Date Sun, 23 Feb 2014 19:13:19 GMT

    [ https://issues.apache.org/jira/browse/ACCUMULO-2394?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13909853#comment-13909853
] 

Josh Elser commented on ACCUMULO-2394:
--------------------------------------

bq. Wouldn't it meet all of the criteria for this issue?

Probably -- the ASF CMS is just much more of a pain to work with IMO. It's also not a part
of the source tree which I'm not a fan of either (you should get the release notes in the
artifact you download just as you do the CHANGES).

Thinking some more, it's not a requirement that the release notes are integrated into the
main a.a.o website. We could link directly to the release notes content hosted elsewhere (just
like CHANGES is now). Exporting isn't a huge concern to me because that's something that isn't
difficult to do. Getting release notes in the release artifacts would arguably require just
as much work (if not more since it has to be put in tarball, rpms and debs).

Overall, I'm not sold on this approach, but I had to the time so I just did it (it literally
didn't take more than about 30mins). Jekyll is so much easier to generally use, provides a
lot of nice features in building something like this and is easier to get installed. Integration
with everything else is a concern.

> Create release notes
> --------------------
>
>                 Key: ACCUMULO-2394
>                 URL: https://issues.apache.org/jira/browse/ACCUMULO-2394
>             Project: Accumulo
>          Issue Type: Task
>          Components: docs
>            Reporter: Josh Elser
>
> The big point that came out of the massive discussion on the CHANGES file is that we
should also be generating an easy-to-consume release notes page.
> Ideally, we want something visually appealing, easy for us to maintain, version controlled
and not requiring manual HTML (e.g. Markdown, etc).



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)

Mime
View raw message