You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openoffice.apache.org by Oliver-Rainer Wittmann <or...@googlemail.com> on 2014/03/12 12:30:48 UTC
[DOCUMENTATION] better installation guide - issue 124343 and issue
124400
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.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124400 and
issue 124408
Posted by Kay Schenk <ka...@gmail.com>.
On Fri, Mar 14, 2014 at 2:19 PM, Marcus (OOo) <ma...@wtnet.de> wrote:
> OK, back to topic. Therefore top posting.
>
> I was a bit curious. So, I did a little test.
>
> The "instructions.html" file does not contain any references about CSS.
> So, I included the "styles.css" and "exceptions.css" files and looked at
> the local file --> It changed the layout.
>
oops! I am probably responsible for that...
>
> Now I committed the file to the test area into staging and compared old
> [1] and new [2]. Now the headings can be identified as headings again.
>
> If this is looking nice is a different topic. ;-)
>
> [1] http://ooo-site.staging.apache.org/download/common/instructions.html
> [2] http://ooo-site.staging.apache.org/download/test/instructions.html
>
> Marcus
>
This IS better. I think if we fixed the styling for <h2> tag to add some
spacing at the top, we'd be in business!
Thanks for tracking this down.
>
>
> Am 03/14/2014 09:46 PM, schrieb Marcus (OOo):
>
> Am 03/14/2014 08:20 AM, schrieb Oliver-Rainer Wittmann:
>>
>>> Hi,
>>>
>>> On 13.03.2014 21:52, Marcus (OOo) wrote:
>>>
>>>> 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.
>>>>
>>>>
>>> No, I do not expect any code.
>>> Just feedback as you have given, but also alternative suggestions, when
>>> my proposed changes are not your favorites.
>>>
>>> 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. ;-)
>>>>
>>>
>>> No, but I mad a mistake - see below.
>>>
>>>
>>>> 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.
>>>>
>>>>
>>> Damn, now I know what went wrong.
>>> I referenced the wrong issues - I am sorry.
>>>
>>> It is 124400 for the formatting on the installation guide website
>>> and 124408 [1] for the content on the installation guide website.
>>>
>>> That is why I was puzzled by your suggestion to 'start improving content
>>> and then look on formatting'.
>>>
>>
>> ah, got it. :-)
>>
>> Thus, content and formatting of our installation guide is what I want to
>>> work on
>>>
>>> [1] https://issues.apache.org/ooo/show_bug.cgi?id=124408 - Improve AOO
>>> Installation Guide
>>>
>>
>> With the content I think I cannot help. I've just Linux and my
>> installation is just:
>>
>> cd <path_to_RPMS>
>> sudo rpm -ivh *
>>
>> I don't care about icons, system integration as I don't use it anyway.
>>
>> But I can work on the styling if it's OK.
>>
>> My suggestion remains:
>>
>> 1. Improve the content.
>> 2. Then we know the document structure.
>> 3. Then we can improve the styling.
>>
>> If there a good reasons, we can start to improve the styling earlier of
>> course.
>>
>> Marcus
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@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 124400 and
issue 124408
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
OK, back to topic. Therefore top posting.
I was a bit curious. So, I did a little test.
The "instructions.html" file does not contain any references about CSS.
So, I included the "styles.css" and "exceptions.css" files and looked at
the local file --> It changed the layout.
Now I committed the file to the test area into staging and compared old
[1] and new [2]. Now the headings can be identified as headings again.
If this is looking nice is a different topic. ;-)
[1] http://ooo-site.staging.apache.org/download/common/instructions.html
[2] http://ooo-site.staging.apache.org/download/test/instructions.html
Marcus
Am 03/14/2014 09:46 PM, schrieb Marcus (OOo):
> Am 03/14/2014 08:20 AM, schrieb Oliver-Rainer Wittmann:
>> Hi,
>>
>> On 13.03.2014 21:52, Marcus (OOo) wrote:
>>> 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.
>>>
>>
>> No, I do not expect any code.
>> Just feedback as you have given, but also alternative suggestions, when
>> my proposed changes are not your favorites.
>>
>>>>> 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. ;-)
>>
>> No, but I mad a mistake - see below.
>>
>>>
>>>>> 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.
>>>
>>
>> Damn, now I know what went wrong.
>> I referenced the wrong issues - I am sorry.
>>
>> It is 124400 for the formatting on the installation guide website
>> and 124408 [1] for the content on the installation guide website.
>>
>> That is why I was puzzled by your suggestion to 'start improving content
>> and then look on formatting'.
>
> ah, got it. :-)
>
>> Thus, content and formatting of our installation guide is what I want to
>> work on
>>
>> [1] https://issues.apache.org/ooo/show_bug.cgi?id=124408 - Improve AOO
>> Installation Guide
>
> With the content I think I cannot help. I've just Linux and my
> installation is just:
>
> cd <path_to_RPMS>
> sudo rpm -ivh *
>
> I don't care about icons, system integration as I don't use it anyway.
>
> But I can work on the styling if it's OK.
>
> My suggestion remains:
>
> 1. Improve the content.
> 2. Then we know the document structure.
> 3. Then we can improve the styling.
>
> If there a good reasons, we can start to improve the styling earlier of
> course.
>
> Marcus
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124400 and
issue 124408
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
Am 03/14/2014 08:20 AM, schrieb Oliver-Rainer Wittmann:
> Hi,
>
> On 13.03.2014 21:52, Marcus (OOo) wrote:
>> 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.
>>
>
> No, I do not expect any code.
> Just feedback as you have given, but also alternative suggestions, when
> my proposed changes are not your favorites.
>
>>>> 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. ;-)
>
> No, but I mad a mistake - see below.
>
>>
>>>> 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.
>>
>
> Damn, now I know what went wrong.
> I referenced the wrong issues - I am sorry.
>
> It is 124400 for the formatting on the installation guide website
> and 124408 [1] for the content on the installation guide website.
>
> That is why I was puzzled by your suggestion to 'start improving content
> and then look on formatting'.
ah, got it. :-)
> Thus, content and formatting of our installation guide is what I want to
> work on
>
> [1] https://issues.apache.org/ooo/show_bug.cgi?id=124408 - Improve AOO
> Installation Guide
With the content I think I cannot help. I've just Linux and my
installation is just:
cd <path_to_RPMS>
sudo rpm -ivh *
I don't care about icons, system integration as I don't use it anyway.
But I can work on the styling if it's OK.
My suggestion remains:
1. Improve the content.
2. Then we know the document structure.
3. Then we can improve the styling.
If there a good reasons, we can start to improve the styling earlier of
course.
Marcus
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124400 and
issue 124408
Posted by Kay Schenk <ka...@gmail.com>.
On 03/14/2014 12:20 AM, Oliver-Rainer Wittmann wrote:
> Hi,
>
> On 13.03.2014 21:52, Marcus (OOo) wrote:
>> 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.
>>
>
> No, I do not expect any code.
> Just feedback as you have given, but also alternative suggestions, when
> my proposed changes are not your favorites.
>
>>>> 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. ;-)
>
> No, but I mad a mistake - see below.
>
>>
>>>> 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.
>>
>
> Damn, now I know what went wrong.
> I referenced the wrong issues - I am sorry.
>
> It is 124400 for the formatting on the installation guide website
> and 124408 [1] for the content on the installation guide website.
>
> That is why I was puzzled by your suggestion to 'start improving content
> and then look on formatting'.
>
> Thus, content and formatting of our installation guide is what I want to
> work on
>
> [1] https://issues.apache.org/ooo/show_bug.cgi?id=124408 - Improve AOO
> Installation Guide
>
>
> Best regards, Oliver.
>
Got it! :} I'm sure we can do both -- with some help from the community!
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124400 and
issue 124408
Posted by Oliver-Rainer Wittmann <or...@googlemail.com>.
Hi,
On 13.03.2014 21:52, Marcus (OOo) wrote:
> 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.
>
No, I do not expect any code.
Just feedback as you have given, but also alternative suggestions, when
my proposed changes are not your favorites.
>>> 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. ;-)
No, but I mad a mistake - see below.
>
>>> 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.
>
Damn, now I know what went wrong.
I referenced the wrong issues - I am sorry.
It is 124400 for the formatting on the installation guide website
and 124408 [1] for the content on the installation guide website.
That is why I was puzzled by your suggestion to 'start improving content
and then look on formatting'.
Thus, content and formatting of our installation guide is what I want to
work on
[1] https://issues.apache.org/ooo/show_bug.cgi?id=124408 - Improve AOO
Installation Guide
Best regards, Oliver.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by Oliver-Rainer Wittmann <or...@googlemail.com>.
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-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by Kay Schenk <ka...@gmail.com>.
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)<ma...@wtnet.de>
>> 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<h3> 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-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
Am 03/13/2014 01:08 AM, schrieb Kay Schenk:
> On Wed, Mar 12, 2014 at 1:15 PM, Marcus (OOo)<ma...@wtnet.de> 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<h3> 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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by Kay Schenk <ka...@gmail.com>.
On Wed, Mar 12, 2014 at 1:15 PM, Marcus (OOo) <ma...@wtnet.de> 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 <h3> 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-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@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
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by Oliver-Rainer Wittmann <or...@googlemail.com>.
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-unsubscribe@openoffice.apache.org
>> For additional commands, e-mail: dev-help@openoffice.apache.org
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [DOCUMENTATION] better installation guide - issue 124343 and
issue 124400
Posted by Kay Schenk <ka...@gmail.com>.
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-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@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-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org