Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-13 Thread Kay Schenk


On 03/13/2014 01:51 PM, Marcus (OOo) wrote:

Am 03/13/2014 01:08 AM, schrieb Kay Schenk:

On Wed, Mar 12, 2014 at 1:15 PM, Marcus (OOo)
wrote:


Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:

  Hi,


Rainer recently noticed that our installation guides needs
improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer



I can support you with the webdesign. Maybe it's gets a bit hard (when I
read Kay's mail ;-) ) but I would try.



Well this one particular stylesheet is a holdover from the "old" days, so
it's rather needlessly complex.


We have the "ooo.css" and on some pages also the "styles.css". And then
somethimes the "exceptions.css" to make exceptions to the general
styling. Yes, pretty complex. ;-)


and don't forget home.css for styling on the home page only! :)



I'm not guru enough to explain roughly the details how it works. I need
to dig in deeper.


...and it looks like I erred in my reference since the  in the
installation instructions stands alone and not in a "subsection". At any
rate, at one time it was italicized -- now it's not, and I don't see any
changes to this stylesheet file in a long time, so it's a puzzle to me.

I am also working on some html changes currently (cleanup of a pdf to
html
for publication) , so I will have a look as well over the next few days.


For me it's OK if you want to take over to improve the styling.

Marcus


I will help. But I may not be able to get to much until early next week.

We should probably not edit /css/ooo.css.

I will likely make changes to our "main" stylsheet -- styles.css.

We do need help with heading differentiation and this should be pretty 
simple.







  Issue 124343:

This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.



This is a central CSS file. Changes here would affect nearly all
webpages.
This needs to be treated very carefully.


  Does it makes sense to make more or less all headings on our
website bold?




No, I'm pretty sure here and there it wouldn't be the intended style.


  Are there alternatives to improve the visibility of heading?

Should we make all heading italic or larger?



Again no. ;-)

I would start with improving the text content. Then we should think
about
the formatting.

What do you think?


  Issue 124400:

I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.



OK


  Thanks in advance for your review and feedback.



[1] http://svn.apache.org/viewvc/openoffice/site/trunk/content/
css/ooo.css



Marcus


-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



--
-
MzK

"Cats do not have to be shown how to have a good time,
 for they are unfailing ingenious in that respect."
   -- James Mason

-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-13 Thread Marcus (OOo)

Am 03/13/2014 09:36 AM, schrieb Oliver-Rainer Wittmann:

Hi,

On 12.03.2014 21:15, Marcus (OOo) wrote:

Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:

Hi,

Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer


I can support you with the webdesign. Maybe it's gets a bit hard (when I
read Kay's mail ;-) ) but I would try.


Issue 124343:
This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.


This is a central CSS file. Changes here would affect nearly all
webpages. This needs to be treated very carefully.


Does it makes sense to make more or less all headings on our website
bold?


No, I'm pretty sure here and there it wouldn't be the intended style.


Are there alternatives to improve the visibility of heading?
Should we make all heading italic or larger?


Again no. ;-)



Such a feedback does not help as you only say no, no, no, ... without
any alternative suggestion :-)


I'm sorry when you expected some code or else. But without looking 
closer into the CSS styling I wouldn't do anything.



I would start with improving the text content. Then we should think
about the formatting.


BTW:
This was my suggestion. Maybe you have overlooked it. ;-)


What do you think?


Hm. We have issue 124343 for the formatting and issue 124400 for the
content.
Changing the words of a heading will not improve its visibility. Thus, I
think that these issues can be treated separately.


https://issues.apache.org/ooo/show_bug.cgi?id=124400
Website: Installation guides: Headings do not look like headings

https://issues.apache.org/ooo/show_bug.cgi?id=124343
Website: Bugzilla documentation: Headings do not look like headings

For me it's the same - just 2 different websites. I've adjusted the 
issue summaries.


Marcus




Issue 124400:
I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.


OK


Thanks in advance for your review and feedback.


[1]
http://svn.apache.org/viewvc/openoffice/site/trunk/content/css/ooo.css


Marcus


-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-13 Thread Marcus (OOo)

Am 03/13/2014 01:08 AM, schrieb Kay Schenk:

On Wed, Mar 12, 2014 at 1:15 PM, Marcus (OOo)  wrote:


Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:

  Hi,


Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer



I can support you with the webdesign. Maybe it's gets a bit hard (when I
read Kay's mail ;-) ) but I would try.



Well this one particular stylesheet is a holdover from the "old" days, so
it's rather needlessly complex.


We have the "ooo.css" and on some pages also the "styles.css". And then 
somethimes the "exceptions.css" to make exceptions to the general 
styling. Yes, pretty complex. ;-)


I'm not guru enough to explain roughly the details how it works. I need 
to dig in deeper.



...and it looks like I erred in my reference since the  in the
installation instructions stands alone and not in a "subsection". At any
rate, at one time it was italicized -- now it's not, and I don't see any
changes to this stylesheet file in a long time, so it's a puzzle to me.

I am also working on some html changes currently (cleanup of a pdf to html
for publication) , so I will have a look as well over the next few days.


For me it's OK if you want to take over to improve the styling.

Marcus




  Issue 124343:

This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.



This is a central CSS file. Changes here would affect nearly all webpages.
This needs to be treated very carefully.


  Does it makes sense to make more or less all headings on our website bold?




No, I'm pretty sure here and there it wouldn't be the intended style.


  Are there alternatives to improve the visibility of heading?

Should we make all heading italic or larger?



Again no. ;-)

I would start with improving the text content. Then we should think about
the formatting.

What do you think?


  Issue 124400:

I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.



OK


  Thanks in advance for your review and feedback.



[1] http://svn.apache.org/viewvc/openoffice/site/trunk/content/
css/ooo.css



Marcus


-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-13 Thread Oliver-Rainer Wittmann

Hi,

On 12.03.2014 17:35, Kay Schenk wrote:


On 03/12/2014 04:30 AM, Oliver-Rainer Wittmann wrote:

Hi,

Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer


Issue 124343:
This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.
Does it makes sense to make more or less all headings on our website
bold?
Are there alternatives to improve the visibility of heading?
Should we make all heading italic or larger?


Issue 124400:
I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.
Thanks in advance for your review and feedback.


[1]
http://svn.apache.org/viewvc/openoffice/site/trunk/content/css/ooo.css


Best regards, Oliver.


Rainer has a point. I remember at one time that "h3" (probably the main
concern here) used to display as described in styles.css

h3.subSection{font-style:italic;text-transform:uppercase;font-size:1.3em;font-weight:bold;}


I'm not sure what's changed to produce what's happening now.

"css/ooo.css" is the default supplied by Apache CMS but our local style
sheets, also brought in, should override this. (And, yes, they are a bit
of a mess!)

Well I can help with this but I'm not what the processing order is now.



Thanks for the offer to help here.
I used Firefox's build-in Inspector and Style Editor (Menu Tools - Web 
Developer - Inspector|Style Editor) to investigate the used styling.


Best regards, Oliver.



-
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



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-13 Thread Oliver-Rainer Wittmann

Hi,

On 12.03.2014 21:15, Marcus (OOo) wrote:

Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:

Hi,

Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer


I can support you with the webdesign. Maybe it's gets a bit hard (when I
read Kay's mail ;-) ) but I would try.


Issue 124343:
This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.


This is a central CSS file. Changes here would affect nearly all
webpages. This needs to be treated very carefully.


Does it makes sense to make more or less all headings on our website
bold?


No, I'm pretty sure here and there it wouldn't be the intended style.


Are there alternatives to improve the visibility of heading?
Should we make all heading italic or larger?


Again no. ;-)



Such a feedback does not help as you only say no, no, no, ... without 
any alternative suggestion :-)



I would start with improving the text content. Then we should think
about the formatting.

What do you think?


Hm. We have issue 124343 for the formatting and issue 124400 for the 
content.
Changing the words of a heading will not improve its visibility. Thus, I 
think that these issues can be treated separately.



Best regards, Oliver.




Issue 124400:
I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.


OK


Thanks in advance for your review and feedback.


[1]
http://svn.apache.org/viewvc/openoffice/site/trunk/content/css/ooo.css


Marcus

-
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



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-12 Thread Kay Schenk
On Wed, Mar 12, 2014 at 1:15 PM, Marcus (OOo)  wrote:

> Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:
>
>  Hi,
>>
>> Rainer recently noticed that our installation guides needs improvement -
>> see issues 124343 and 124400.
>> I am volunteering to take corresponding actions. But I need support and
>> feedback - I am neither a web designer nor a technical writer
>>
>
> I can support you with the webdesign. Maybe it's gets a bit hard (when I
> read Kay's mail ;-) ) but I would try.


Well this one particular stylesheet is a holdover from the "old" days, so
it's rather needlessly complex.

...and it looks like I erred in my reference since the  in the
installation instructions stands alone and not in a "subsection". At any
rate, at one time it was italicized -- now it's not, and I don't see any
changes to this stylesheet file in a long time, so it's a puzzle to me.

I am also working on some html changes currently (cleanup of a pdf to html
for publication) , so I will have a look as well over the next few days.



>
>
>  Issue 124343:
>> This is about the visibility of the headings.
>> My suggestion here is to make the font used for the headings (all
>> levels) bold. Thus, I would like to propose to change our corresponding
>> CSS [1].
>>
>> Please provide feedback regarding my suggestion.
>>
>
> This is a central CSS file. Changes here would affect nearly all webpages.
> This needs to be treated very carefully.
>
>
>  Does it makes sense to make more or less all headings on our website bold?
>>
>
> No, I'm pretty sure here and there it wouldn't be the intended style.
>
>
>  Are there alternatives to improve the visibility of heading?
>> Should we make all heading italic or larger?
>>
>
> Again no. ;-)
>
> I would start with improving the text content. Then we should think about
> the formatting.
>
> What do you think?
>
>
>  Issue 124400:
>> I will prepare the corresponding changes and I will ask for feedback
>> once the changes are on the staging server.
>>
>
> OK
>
>
>  Thanks in advance for your review and feedback.
>>
>>
>> [1] http://svn.apache.org/viewvc/openoffice/site/trunk/content/
>> css/ooo.css
>>
>
> Marcus
>
>
> -
> To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
> For additional commands, e-mail: dev-h...@openoffice.apache.org
>
>


-- 
-
MzK

"Cats do not have to be shown how to have a good time,
 for they are unfailing ingenious in that respect."
   -- James Mason


Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-12 Thread Marcus (OOo)

Am 03/12/2014 12:30 PM, schrieb Oliver-Rainer Wittmann:

Hi,

Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer


I can support you with the webdesign. Maybe it's gets a bit hard (when I 
read Kay's mail ;-) ) but I would try.



Issue 124343:
This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.


This is a central CSS file. Changes here would affect nearly all 
webpages. This needs to be treated very carefully.



Does it makes sense to make more or less all headings on our website bold?


No, I'm pretty sure here and there it wouldn't be the intended style.


Are there alternatives to improve the visibility of heading?
Should we make all heading italic or larger?


Again no. ;-)

I would start with improving the text content. Then we should think 
about the formatting.


What do you think?


Issue 124400:
I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.


OK


Thanks in advance for your review and feedback.


[1] http://svn.apache.org/viewvc/openoffice/site/trunk/content/css/ooo.css


Marcus

-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



Re: [DOCUMENTATION] better installation guide - issue 124343 and issue 124400

2014-03-12 Thread Kay Schenk


On 03/12/2014 04:30 AM, Oliver-Rainer Wittmann wrote:

Hi,

Rainer recently noticed that our installation guides needs improvement -
see issues 124343 and 124400.
I am volunteering to take corresponding actions. But I need support and
feedback - I am neither a web designer nor a technical writer


Issue 124343:
This is about the visibility of the headings.
My suggestion here is to make the font used for the headings (all
levels) bold. Thus, I would like to propose to change our corresponding
CSS [1].

Please provide feedback regarding my suggestion.
Does it makes sense to make more or less all headings on our website bold?
Are there alternatives to improve the visibility of heading?
Should we make all heading italic or larger?


Issue 124400:
I will prepare the corresponding changes and I will ask for feedback
once the changes are on the staging server.
Thanks in advance for your review and feedback.


[1] http://svn.apache.org/viewvc/openoffice/site/trunk/content/css/ooo.css


Best regards, Oliver.


Rainer has a point. I remember at one time that "h3" (probably the main 
concern here) used to display as described in styles.css


h3.subSection{font-style:italic;text-transform:uppercase;font-size:1.3em;font-weight:bold;}

I'm not sure what's changed to produce what's happening now.

"css/ooo.css" is the default supplied by Apache CMS but our local style 
sheets, also brought in, should override this. (And, yes, they are a bit 
of a mess!)


Well I can help with this but I'm not what the processing order is now.



-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org



--
-
MzK

"Cats do not have to be shown how to have a good time,
 for they are unfailing ingenious in that respect."
   -- James Mason

-
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org