incubator-ooo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dennis E. Hamilton" <dennis.hamil...@acm.org>
Subject RE: RC Readmes point to Wiki ML Page that needs Update
Date Mon, 23 Apr 2012 21:07:47 GMT
I did some double-checking of RC1 and updated <https://issues.apache.org/ooo/show_bug.cgi?id=119217>.

The most interesting aspect is that there are a total of six readme copies in the install;
the only NOTICE and LICENSE files are in an obscure place.  Here is the layout:

$PROGRAMFILES$\
   OpenOffice.org 3\
      readme.html
      readme.txt
      readmes\
          readme_en-US.html
          readme_en-US.txt
      share\
          readme\
              LICENSE.txt
              NOTICE.txt
              readme_en-US.html
              readme_en-US.txt

The readme files appear to be identical.  They also seem to be identical to the ones in the
previous developer snapshots.  

There are some differences in the web-site locations being referenced, but it is still very
confusing.  Most of the readme information is irrelevant to what needs to be known about the
specific release.

I could not find where in the SVN these files reside.  

 - Dennis

-----Original Message-----
From: Juergen Schmidt [mailto:jogischmidt@googlemail.com] 
Sent: Sunday, April 22, 2012 17:16
To: ooo-dev@incubator.apache.org; dennis.hamilton@acm.org
Subject: Re: RC Readmes point to Wiki ML Page that needs Update

On Monday, 23. April 2012 at 07:37, Dennis E. Hamilton wrote:
> I did a complete QA read-through and link check on the r1309668 Windows Readme,
> <https://issues.apache.org/ooo/show_bug.cgi?id=119217>. I haven't checked the one
in RC1 yet. 
> 
> I saw a lot to clean up. 
That is nothing new and we already have discussed that the readme has to be reworked completely.
But it is more work and the readme for the binaries are different to the one in the src release.
It contains also platform dependent content and I think that can make sense to point on platform
dependent stuff. The intention here is and was to make it more and better readable.

But anyway the work needs to be done by somebody. If somebody is volunteering here I can help
to find the right places.

I would move this cleanup work to the next version because it requires translation effort.

Juergen
> The easiest solution would be to cut back the readme to have only essential information
that is important to have there, with only a couple of links to related material. 
> 
> The problem with target links at openoffice.org is that many of those have been turned
into compendium pages, so you have to hunt for the information the readme is saying will be
found there. The net effect is to make it too much work for the users. 
> 
> - Dennis
> 
> -----Original Message-----
> From: Dave Fisher [mailto:dave2wave@comcast.net] 
> Sent: Sunday, April 22, 2012 14:03
> To: ooo-dev@incubator.apache.org
> Subject: Re: RC Readmes point to Wiki ML Page that needs Update
> 
> 
> On Apr 22, 2012, at 1:54 PM, drew wrote:
> 
> > On Sun, 2012-04-22 at 16:41 -0400, TJ Frazier wrote:
> > > On 4/22/2012 15:31, Dave Fisher wrote:
> > > > Hi -
> > > > 
> > > > While evaluating the RC, I reviewed the MacOSX Readme file. This points
to the old OOo wiki page[1] with OOo MLs:
> > > > 
> > > > Would someone please update this page?
> > > > 
> > > > Regards,
> > > > Dave
> > > > 
> > > > [1] http://wiki.services.openoffice.org/wiki/Website/Content/help/mailinglists
> > > Hi, Dave,
> > > 
> > > I fixed the sub-unsub links, but (sorry to admit it) I don't know enough 
> > > to provide the archive link(s). I'd really like to say something like, 
> > > "The ooo-users ML is archived at "[LINK]". The former OpenOffice.org ML 
> > > is archived at "[LINK2]"." If I knew what to say ...
> > > 
> > 
> > Hi tj
> > 
> > Was thinking the same thing, I think I'll set it up as a table with 
> > live links | Active Archive(s) asf, markmail | Inactive Archive(s) markmail, etc
> > 
> > It won't take long to do the languages we have currently. With a section
> > referring, as custom, others to the en lists.
> > 
> > Near what you were thinking of also?
> 
> That would work. Then we build a redirection to handle the legacy http://openoffice.org/projects/*
links...
> 
> So the table can be a separate page.
> 
> Regards,
> Dave
> 
> > 
> > //drew 



Mime
View raw message