On Sat, Jul 13, 2013 at 3:17 PM, Rob Weir <robw...@apache.org> wrote:
> On Fri, Jul 12, 2013 at 7:54 PM, Kay Schenk <kay.sch...@gmail.com> wrote: > > On Fri, Jul 12, 2013 at 4:45 PM, Rob Weir <robw...@apache.org> wrote: > > > >> On Fri, Jul 12, 2013 at 3:52 PM, Kay Schenk <kay.sch...@gmail.com> > wrote: > >> > On Fri, Jul 12, 2013 at 12:17 PM, Rob Weir <rabas...@gmail.com> > wrote: > >> > > >> >> On Jul 12, 2013, at 2:26 PM, "Marcus (OOo)" <marcus.m...@wtnet.de> > >> wrote: > >> >> > >> >> > Am 07/12/2013 07:18 PM, schrieb janI: > >> >> >> On 12 July 2013 18:49, Rob Weir<robw...@apache.org> wrote: > >> >> >> > >> >> >>> In the past we drafted release notes on the wiki, and then moved > >> them > >> >> >>> to a location on the website. I'd like to challenge our > thinking on > >> >> >>> this. > >> >> >>> > >> >> >>> Wouldn't it be useful to keep the release notes as a "live" > document > >> >> >>> on the wiki, so we can easily update it with additional > information > >> on > >> >> >>> known issues as they are found, especially after release? > >> >> >> > >> >> >> I see your point, however I disagree. > >> >> >> > >> >> >> I think the release doc. for 4.0 is part of the release and > should be > >> >> >> frozen in svn like all other release artifacts. This is done by > >> having > >> >> it > >> >> >> as a static web page. > >> >> > > >> >> > I support the doubts of Jan. > >> >> > > >> >> > The release notes should be seen as an artifact from a release as > they > >> >> describe this. We can also go that far that we write down the SVN > >> revision > >> >> number into the release notes. Then they are really tied strictly to > >> this > >> >> release and nothing else. > >> >> > > >> >> > >> >> And I did not mean to suggest anything else. The wiki page would be > >> >> tied to a specific version of AOO, a different page for each version. > >> >> But it would be updated to reflect the latest info, especially in > the > >> >> "known problems" section. > >> >> > >> >> > >> >> > >> >> >> We can then have a "latest information", which are live in wiki. > >> >> > > >> >> > What about to put a link like this at the top of the release notes > to > >> >> give it more visible attention: > >> >> > > >> >> > Text: "For the latest information about Apache OpenOffice 4.0 see > >> >> > this related Wiki page." > >> >> > Link: http://wiki.openoffice.org/wiki/AOO400_Lastest_Info > >> >> > > >> >> > >> >> Look at it from the perspective of the user. They want one place to > go > >> >> for relevant info related to the release and problems they might > >> >> encounter. They don't want to hunt around for "old" versus "new" > info. > >> >> Those distinctions are not relevant to a new user. > >> >> > >> >> For example, imagine Windows 8.1 comes out and causes a problem with > >> >> AOO4, but there is a good workaround that could save the user much > >> >> frustration. But the release notes don't mention this. They just say > >> >> Windows 8 is tested. This is not very helpful. > >> >> > >> >> > >> >> > Then new and important / noteable changes can be documented in the > >> (more > >> >> easily accessible) Wiki. > >> >> > > >> >> > >> >> My proposal was to handle this by keeping the release notes on a wiki > >> >> page so such changes are seen by users with the least effort for them > >> >> and us. > >> >> > >> >> -Rob > >> >> > >> > > >> > Arguments either way it seems. Leaving them on the wiki would > certainly > >> be > >> > good especially for last minute changes -- which have happened. I > guess > >> it > >> > boils down to -- when a release is announced, where are the Release > Notes > >> > of record? and if things change -- i.e. *New* Discovered Issues, as > >> opposed > >> > to Known Issues in the Release Notes -- should this be kept as a > separate > >> > entity that is not part of the Release Notes of record? OK, a lot of > >> legal > >> > gobbly gook I guess > >> > > >> > >> Two separate considerations, perhaps: > >> > >> 1) Whether Release Notes are updated overtime, post-release, based on > >> feedback from users and discovery of new issues? Or are they > >> frozen-in-time, snapshots that never change, but might point to a > >> different page that is updated. > >> > >> 2) What technology we use to create, publish and (if needed) update > >> the release notes. > >> > >> It is possible to have a "living" document for Release Notes and do it > >> entirely in HTML on the website. It is possible to do it on the wiki. > >> It is even possible to do it on the committer-only CWiki. (Anyone > >> remember that we have that?) > >> > > > > NO -- I do not remember or even know anything about this. I think if we > > utilized that approach, maybe this is an equitable solution. > > > > https://cwiki.apache.org/confluence/display/OOODEV/Wiki+Home > > This was created when we first started as a podling. But we never > really used it. > > -Rob > Let's just go ahead and use that area if you want to move the Release Notes. At some point, we may want to make a copy for the web -- but right now this isn't critical for me as long as the "working" copy is in a relatively secure area. Time to get our links finalized. I think Confluence may automatically adjust references for those working on this who have the old location bookmarked. > > > >> Since we all seem to like drafting the release notes on the wiki, it > >> might reduce the work if we just keep it there. It makes it easier > >> for translators as well. But I'm not too concerned with the except > >> technology used. I'm more concerned with keeping it up to date, and > >> easy to understand. > > > > > > I understand. > > > > > >> In other words, if we have a section called > >> "known issues", I want it to remain accurate as new issues are > >> discovered. It is 2013 and this is the internet. We shouldn't have a > >> "let's slip an errata sheet into a hardbound book" mentality about > >> this. > >> > > > > Your points are good for this. Really my major concern with the wiki was > > maybe the ease of unwarranted edits. Other than that, I'm fine with > > this...dealing with proting it to web server is not that hard but a step > we > > might all be happy to avoid. > > > > now to look into the Committer only wiki (???) > > > > > > > >> > >> > I personally find it annoying to get "instructions" and "issues" at a > >> site > >> > one day, that somehow morph into something else the next. Even if > these > >> > things are not legally binding, there's that sort of confusion factor. > >> > > >> > >> I think most users consult the page rarely. They might look once when > >> they install initially. And then they look again perhaps, if they run > >> into a problem. > > > > > > yes...I agree. Sadly, I see the Install instructions are hardly used at > > all, but I think "for the record", we need to have them. > > > > > > > >> One advantage of the release notes in particular (and > >> this is true of no other page) is that they tend to have higher Google > >> PageRank, because they are linked to from news articles. So users who > >> query for things like "apache openoffice 4.0 issues" will tend to find > >> that page high on their results list. This would not be true for > >> issues that we push off to another, secondary page. > >> > > > > OK... > > > > > >> > >> > I, too, really don't like the idea of anyone with a wiki account being > >> able > >> > to change these, especially with the possibility of no general > >> > consultation or consensus. > >> > > >> > >> There are ways of handling this that control the ACL, such as using > >> the OOODEV CWiki, or even using static HTML or MDText pages, if the > >> open access of the wiki is a concern. > >> > > > > I know about the OOODEV CWiki, -- I just never tried to access it. > > > > I'm OK with using that area for the Release Notes. > > > > > > > >> Regards, > >> > >> -Rob > >> > >> > > >> > > >> >> > My 2 ct. > >> >> > > >> >> > Marcus > >> >> > > >> >> > > >> >> > > >> >> >>> Remember, even if the issue is not caused by AOO code, a new > upgrade > >> >> >>> to a dependent operating system or other 3rd party application > can > >> >> >>> cause new issues to appear at any time. So keeping the release > >> notes > >> >> >>> updated is important. > >> >> >> > >> >> >> This issue is highly caused by AOO code, remember the release > code is > >> >> >> tested with a given set of third party libraries and given > versions > >> of > >> >> the > >> >> >> operating systems. > >> >> >> > >> >> >> Release notes reflect the environment tested for the 4.0 release, > >> >> >> everything that comes later should either be kept in a separate > >> >> document or > >> >> >> postponed to a new release. > >> >> >> > >> >> >> > >> >> >>> > >> >> >>> Do we lose anything if we do this? For example, is there a > concern > >> >> >>> that the wiki can not handle the load? > >> >> >> > >> >> >> Wiki can handle the load (it must because a lot of people will > search > >> >> for > >> >> >> info). > >> >> >> > >> >> >> Yes we loose trackability. Release notes is in svn (in my > opinion). > >> >> >> Remember in wiki anybody can change, so if person X test AOO on > >> >> platform Y > >> >> >> should he/she then just update the release documentation, I hope > >> not. > >> >> >> > >> >> >> But again, your idea of a live document is good, I just see it as > a > >> >> second > >> >> >> document (similar to what a lot of companies does). > >> >> > > >> >> > > --------------------------------------------------------------------- > >> >> > To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org > >> >> > For additional commands, e-mail: dev-h...@openoffice.apache.org > >> >> > > >> >> > >> >> --------------------------------------------------------------------- > >> >> To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org > >> >> For additional commands, e-mail: dev-h...@openoffice.apache.org > >> >> > >> >> > >> > > >> > > >> > -- > >> > > >> > ------------------------------------------------------------------------------------------------- > >> > MzK > >> > > >> > "Every day we should hear at least one little song, > >> > read one good poem, see one exquisite picture, > >> > and, if possible, speak a few sensible words." > >> > -- Johann Wolfgang von Goethe > >> > >> --------------------------------------------------------------------- > >> To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org > >> For additional commands, e-mail: dev-h...@openoffice.apache.org > >> > >> > > > > > > -- > > > ------------------------------------------------------------------------------------------------- > > MzK > > > > "Every day we should hear at least one little song, > > read one good poem, see one exquisite picture, > > and, if possible, speak a few sensible words." > > -- Johann Wolfgang von Goethe > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org > For additional commands, e-mail: dev-h...@openoffice.apache.org > > -- ------------------------------------------------------------------------------------------------- MzK Success is falling nine times and getting up ten." -- Jon Bon Jovi