public inbox for [email protected]
help / color / mirror / Atom feedProposed HTML Documentation Styles
20+ messages / 8 participants
[nested] [flat]
* Proposed HTML Documentation Styles
@ 2018-10-04 15:50 Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-16 14:44 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
0 siblings, 3 replies; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-04 15:50 UTC (permalink / raw)
To: [email protected]; +Cc: Sarah Schnurr <[email protected]>
Hi,
As part of the effort to modernize the look and feel of PostgreSQL.org
and associated web projects, Sarah & I have worked on applying the new
styles to the documentation. The main goals of the project were:
- To have the documentation styles match that of the main website
- To make the documentation easier to view on mobile devices
- To set up the web-based documentation for future usability changes and
improvements
Other than reversing how the versions are display at the top of the
website, we did not change any of the documentation structure and do not
intend to as part of this version of the project.
We have created a prototype of the new styles that can be viewed here,
with the credentials below:
http://174.138.60.30/docs/
pgdocs / newstyles
When browsing through this site, please note:
- All interactions are confined to the "/docs" folder
- Not all of the docs are loaded and they are not all the latest
versions - this is just for beta testing purposes
- Search in the prototype does not work
We are looking for feedback in the following areas:
- Things that may have degraded the user experience, e.g. things that
are difficult to read
- Visual bugs and errors
Our goal is to launch these changes with the upcoming major release, so
we appreciate your diligence in providing helpful feedback so we can
provide the best possible experience.
Thanks,
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-04 16:02 ` Pavel Stehule <[email protected]>
2018-10-04 16:28 ` Re: Proposed HTML Documentation Styles Alvaro Herrera <[email protected]>
2018-10-04 16:31 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2 siblings, 2 replies; 20+ messages in thread
From: Pavel Stehule @ 2018-10-04 16:02 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: [email protected]; [email protected]
čt 4. 10. 2018 v 17:50 odesílatel Jonathan S. Katz <[email protected]>
napsal:
> Hi,
>
> As part of the effort to modernize the look and feel of PostgreSQL.org
> and associated web projects, Sarah & I have worked on applying the new
> styles to the documentation. The main goals of the project were:
>
> - To have the documentation styles match that of the main website
> - To make the documentation easier to view on mobile devices
> - To set up the web-based documentation for future usability changes and
> improvements
>
> Other than reversing how the versions are display at the top of the
> website, we did not change any of the documentation structure and do not
> intend to as part of this version of the project.
>
> We have created a prototype of the new styles that can be viewed here,
> with the credentials below:
>
> http://174.138.60.30/docs/
> pgdocs / newstyles
>
> When browsing through this site, please note:
>
> - All interactions are confined to the "/docs" folder
> - Not all of the docs are loaded and they are not all the latest
> versions - this is just for beta testing purposes
> - Search in the prototype does not work
>
> We are looking for feedback in the following areas:
>
> - Things that may have degraded the user experience, e.g. things that
> are difficult to read
> - Visual bugs and errors
>
When I am going to document, then I see (about 0.5 sec) big PostgreSQL
logo. It is not pleasant effect.
I don't like table style - middle vertical line is too black
Used colour palette is maybe too red based.
All my notes are subjective, just my feeling
Regards
Pavel
> Our goal is to launch these changes with the upcoming major release, so
> we appreciate your diligence in providing helpful feedback so we can
> provide the best possible experience.
>
> Thanks,
>
> Jonathan
>
>
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
@ 2018-10-04 16:28 ` Alvaro Herrera <[email protected]>
2018-10-04 16:33 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
1 sibling, 1 reply; 20+ messages in thread
From: Alvaro Herrera @ 2018-10-04 16:28 UTC (permalink / raw)
To: Pavel Stehule <[email protected]>; +Cc: Jonathan S. Katz <[email protected]>; [email protected]; [email protected]
On 2018-Oct-04, Pavel Stehule wrote:
> čt 4. 10. 2018 v 17:50 odesílatel Jonathan S. Katz <[email protected]>
> napsal:
>
> When I am going to document, then I see (about 0.5 sec) big PostgreSQL
> logo. It is not pleasant effect.
>
> I don't like table style - middle vertical line is too black
>
> Used colour palette is maybe too red based.
Yeah, it's heavily red and I didn't like that very much either, though I
can live with it if everyone else loves it.
This TOC looks a bit odd, with those bold black elements amongst all
that red: http://174.138.60.30/docs/10/static/ecpg.html I suppose these
should just be bold without changing the color.
This page http://174.138.60.30/docs/9.4/static/libpq-connect.html
has some keywords inside "Warning" and "Note" boxes. Those keywords
acquire a gray background instead of inheriting the background color of
the box, as in the original stylesheets. Really odd-looking.
Cheers
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
2018-10-04 16:28 ` Re: Proposed HTML Documentation Styles Alvaro Herrera <[email protected]>
@ 2018-10-04 16:33 ` Jonathan S. Katz <[email protected]>
2018-10-04 18:23 ` Re: Proposed HTML Documentation Styles Daniel Gustafsson <[email protected]>
2018-10-04 22:33 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
0 siblings, 2 replies; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-04 16:33 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; Pavel Stehule <[email protected]>; +Cc: [email protected]; [email protected]
On 10/4/18 12:28 PM, Alvaro Herrera wrote:
> On 2018-Oct-04, Pavel Stehule wrote:
>
>> čt 4. 10. 2018 v 17:50 odesílatel Jonathan S. Katz <[email protected]>
>> napsal:
>>
>> When I am going to document, then I see (about 0.5 sec) big PostgreSQL
>> logo. It is not pleasant effect.
>>
>> I don't like table style - middle vertical line is too black
>>
>> Used colour palette is maybe too red based.
>
> Yeah, it's heavily red and I didn't like that very much either, though I
> can live with it if everyone else loves it.
We can always see if we can find something more palatable. In some
earlier testing there were some issues with the blue, but perhaps there
are some better ways to achieve the proper PostgreSQL color palette.
>
> This TOC looks a bit odd, with those bold black elements amongst all
> that red: http://174.138.60.30/docs/10/static/ecpg.html I suppose these
> should just be bold without changing the color.
>
> This page http://174.138.60.30/docs/9.4/static/libpq-connect.html
> has some keywords inside "Warning" and "Note" boxes. Those keywords
> acquire a gray background instead of inheriting the background color of
> the box, as in the original stylesheets. Really odd-looking.
Thanks - both of the above have been noted and will be fixed.
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
2018-10-04 16:28 ` Re: Proposed HTML Documentation Styles Alvaro Herrera <[email protected]>
2018-10-04 16:33 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-04 18:23 ` Daniel Gustafsson <[email protected]>
1 sibling, 0 replies; 20+ messages in thread
From: Daniel Gustafsson @ 2018-10-04 18:23 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: Alvaro Herrera <[email protected]>; Pavel Stehule <[email protected]>; [email protected]; [email protected]
> On 4 Oct 2018, at 18:33, Jonathan S. Katz <[email protected]> wrote:
>
> On 10/4/18 12:28 PM, Alvaro Herrera wrote:
>> This page http://174.138.60.30/docs/9.4/static/libpq-connect.html
>> has some keywords inside "Warning" and "Note" boxes. Those keywords
>> acquire a gray background instead of inheriting the background color of
>> the box, as in the original stylesheets. Really odd-looking.
>
> Thanks - both of the above have been noted and will be fixed.
Not sure if it’s the same thing, but code blocks on Tip boxes no longer have a
separate background color - only an outline. There is an example on the below
page:
http://174.138.60.30/docs/11/static/functions-matching.html
cheers ./daniel
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
2018-10-04 16:28 ` Re: Proposed HTML Documentation Styles Alvaro Herrera <[email protected]>
2018-10-04 16:33 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-04 22:33 ` Jonathan S. Katz <[email protected]>
1 sibling, 0 replies; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-04 22:33 UTC (permalink / raw)
To: Alvaro Herrera <[email protected]>; Pavel Stehule <[email protected]>; +Cc: [email protected]; [email protected]
On 10/4/18 12:33 PM, Jonathan S. Katz wrote:
> On 10/4/18 12:28 PM, Alvaro Herrera wrote:
>> This TOC looks a bit odd, with those bold black elements amongst all
>> that red: http://174.138.60.30/docs/10/static/ecpg.html I suppose these
>> should just be bold without changing the color.
>>
>> This page http://174.138.60.30/docs/9.4/static/libpq-connect.html
>> has some keywords inside "Warning" and "Note" boxes. Those keywords
>> acquire a gray background instead of inheriting the background color of
>> the box, as in the original stylesheets. Really odd-looking.
>
> Thanks - both of the above have been noted and will be fixed.
Updates for this have been pushed to the test website. Thanks for reporting!
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Re: Proposed HTML Documentation Styles Pavel Stehule <[email protected]>
@ 2018-10-04 16:31 ` Jonathan S. Katz <[email protected]>
1 sibling, 0 replies; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-04 16:31 UTC (permalink / raw)
To: Pavel Stehule <[email protected]>; +Cc: [email protected]; [email protected]
Hi Pavel,
On 10/4/18 12:02 PM, Pavel Stehule wrote:
> When I am going to document, then I see (about 0.5 sec) big PostgreSQL
> logo. It is not pleasant effect.
That's cache related - we won't need to worry about that on the
production site.
>
> I don't like table style - middle vertical line is too black
>
> Used colour palette is maybe too red based.
>
> All my notes are subjective, just my feeling
Thanks for your feedback!
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-04 19:41 ` Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2 siblings, 1 reply; 20+ messages in thread
From: Dean Rasheed @ 2018-10-04 19:41 UTC (permalink / raw)
To: [email protected]; +Cc: [email protected]; [email protected]
On Thu, 4 Oct 2018 at 16:50, Jonathan S. Katz <[email protected]> wrote:
> As part of the effort to modernize the look and feel of PostgreSQL.org
> and associated web projects, Sarah & I have worked on applying the new
> styles to the documentation.
>
> We are looking for feedback in the following areas:
>
> - Things that may have degraded the user experience, e.g. things that
> are difficult to read
> - Visual bugs and errors
>
There seems to be a problem with the layout some of the tables. For
example on this page:
http://174.138.60.30/docs/10/static/functions-math.html
the description column is far too narrow, leading to descriptions with
one or two words per line, spread over dozens of lines.
Regards,
Dean
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
@ 2018-10-09 01:38 ` Jonathan S. Katz <[email protected]>
2018-10-11 05:49 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-09 01:38 UTC (permalink / raw)
To: Dean Rasheed <[email protected]>; +Cc: [email protected]; [email protected]
Hi Dean,
On 10/4/18 3:41 PM, Dean Rasheed wrote:
> On Thu, 4 Oct 2018 at 16:50, Jonathan S. Katz <[email protected]> wrote:
>> As part of the effort to modernize the look and feel of PostgreSQL.org
>> and associated web projects, Sarah & I have worked on applying the new
>> styles to the documentation.
>>
>> We are looking for feedback in the following areas:
>>
>> - Things that may have degraded the user experience, e.g. things that
>> are difficult to read
>> - Visual bugs and errors
>>
>
> There seems to be a problem with the layout some of the tables. For
> example on this page:
>
> http://174.138.60.30/docs/10/static/functions-math.html
>
> the description column is far too narrow, leading to descriptions with
> one or two words per line, spread over dozens of lines.
Sorry for the slow reply on this one - it took a little bit more time to
troubleshoot. This should now be fixed - please let me know if you are
still having issues.
Thanks,
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-11 05:49 ` Dean Rasheed <[email protected]>
2018-10-11 07:01 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Dean Rasheed @ 2018-10-11 05:49 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: [email protected]; [email protected]
On Tue, 9 Oct 2018, 02:38 Jonathan S. Katz, <[email protected]> wrote:
> Hi Dean,
>
> On 10/4/18 3:41 PM, Dean Rasheed wrote:
> > On Thu, 4 Oct 2018 at 16:50, Jonathan S. Katz <[email protected]>
> wrote:
> >> As part of the effort to modernize the look and feel of PostgreSQL.org
> >> and associated web projects, Sarah & I have worked on applying the new
> >> styles to the documentation.
> >>
> >> We are looking for feedback in the following areas:
> >>
> >> - Things that may have degraded the user experience, e.g. things that
> >> are difficult to read
> >> - Visual bugs and errors
> >>
> >
> > There seems to be a problem with the layout some of the tables. For
> > example on this page:
> >
> > http://174.138.60.30/docs/10/static/functions-math.html
> >
> > the description column is far too narrow, leading to descriptions with
> > one or two words per line, spread over dozens of lines.
>
> Sorry for the slow reply on this one - it took a little bit more time to
> troubleshoot. This should now be fixed - please let me know if you are
> still having issues.
>
>
Thanks. That definitely improves things from a normal desktop browser.
However, this still isn't ideal on smaller screens. For example, attached
are screenshots taken from my Android tablet of the bottom of Table 9.5,
comparing the current docs with the new ones.
Regards,
Dean
Attachments:
[image/png] Screenshot_20181011-062959.png (248.7K, 3-Screenshot_20181011-062959.png)
download | view image
[image/png] Screenshot_20181011-062840.png (447.5K, 4-Screenshot_20181011-062840.png)
download | view image
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-11 05:49 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
@ 2018-10-11 07:01 ` Dean Rasheed <[email protected]>
2018-10-12 02:03 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Dean Rasheed @ 2018-10-11 07:01 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: [email protected]; Sarah Conway Schnurr <[email protected]>
On Thu, 11 Oct 2018 at 06:49, Dean Rasheed <[email protected]> wrote:
> For example, attached are screenshots taken from my Android tablet
For the record, that was a Samsung Galaxy Tab S2 8.0, with a screen
resolution of 2048x1536 and a device pixel ratio of 2.0, I think. So
the logical resolution is 1024x768, and in portrait mode, the logical
width is 768 pixels.
Regards,
Dean
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-11 05:49 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-11 07:01 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
@ 2018-10-12 02:03 ` Jonathan S. Katz <[email protected]>
2018-10-14 10:49 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-12 02:03 UTC (permalink / raw)
To: Dean Rasheed <[email protected]>; +Cc: [email protected]; Sarah Conway Schnurr <[email protected]>
Hi Dean,
On 10/11/18 3:01 AM, Dean Rasheed wrote:
> On Thu, 11 Oct 2018 at 06:49, Dean Rasheed <[email protected]> wrote:
>> For example, attached are screenshots taken from my Android tablet
>
> For the record, that was a Samsung Galaxy Tab S2 8.0, with a screen
> resolution of 2048x1536 and a device pixel ratio of 2.0, I think. So
> the logical resolution is 1024x768, and in portrait mode, the logical
> width is 768 pixels.
Unfortunately HTML tables are not great in mobile web. With that said,
we pushed up a change that should keep them from exploding as much to
the right. We've also bumped up the font-size slightly from the current
site so they could be slightly easier to read.
(Note: when testing in the browser, they appear to be illegible unless
you have super vision, but when on an actual device they are legible).
There is only so much we can do now without redesigning how the tables
are assembled.
Thanks again for your feedback!
Best,
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-11 05:49 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-11 07:01 ` Re: Proposed HTML Documentation Styles Dean Rasheed <[email protected]>
2018-10-12 02:03 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-14 10:49 ` Dean Rasheed <[email protected]>
0 siblings, 0 replies; 20+ messages in thread
From: Dean Rasheed @ 2018-10-14 10:49 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: [email protected]; Sarah Conway Schnurr <[email protected]>
On Fri, 12 Oct 2018 at 03:03, Jonathan S. Katz <[email protected]> wrote:
> On 10/11/18 3:01 AM, Dean Rasheed wrote:
> > On Thu, 11 Oct 2018 at 06:49, Dean Rasheed <[email protected]> wrote:
> >> For example, attached are screenshots taken from my Android tablet
> >
> > For the record, that was a Samsung Galaxy Tab S2 8.0, with a screen
> > resolution of 2048x1536 and a device pixel ratio of 2.0, I think. So
> > the logical resolution is 1024x768, and in portrait mode, the logical
> > width is 768 pixels.
>
> Unfortunately HTML tables are not great in mobile web. With that said,
> we pushed up a change that should keep them from exploding as much to
> the right. We've also bumped up the font-size slightly from the current
> site so they could be slightly easier to read.
>
> (Note: when testing in the browser, they appear to be illegible unless
> you have super vision, but when on an actual device they are legible).
>
> There is only so much we can do now without redesigning how the tables
> are assembled.
>
Indeed. It's probably unrealistic to try to support really small
devices. I mentioned that particular one because there was a clear
regression from the old style. I have re-tested it and now it's much
better, so thanks for the fix.
Arguably, the font scaling in the @media CSS is now a little too
aggressive. IMO 60% rather than 50% is a little more readable for the
576-768px range, and 80% rather than 70% for the 769-992px range, but
that's a very subjective matter.
Regards,
Dean
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-16 14:44 ` Jonathan S. Katz <[email protected]>
2018-10-22 16:14 ` Re: Proposed HTML Documentation Styles Liudmila Mantrova <[email protected]>
2018-10-23 22:02 ` Re: Proposed HTML Documentation Styles James Cloos <[email protected]>
2 siblings, 2 replies; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-16 14:44 UTC (permalink / raw)
To: [email protected]; +Cc: Sarah Schnurr <[email protected]>
On 10/4/18 11:50 AM, Jonathan S. Katz wrote:
> Hi,
>
> As part of the effort to modernize the look and feel of PostgreSQL.org
> and associated web projects, Sarah & I have worked on applying the new
> styles to the documentation. The main goals of the project were:
>
> - To have the documentation styles match that of the main website
> - To make the documentation easier to view on mobile devices
> - To set up the web-based documentation for future usability changes and
> improvements
Thank you everyone for your feedback. We launched the new documentation
styles this morning. Please let us know if you find any issues or have
any additional feedback.
Thanks,
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-16 14:44 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-22 16:14 ` Liudmila Mantrova <[email protected]>
2018-10-22 16:29 ` Re: Proposed HTML Documentation Styles Alvaro Herrera <[email protected]>
1 sibling, 1 reply; 20+ messages in thread
From: Liudmila Mantrova @ 2018-10-22 16:14 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; [email protected]; +Cc: Sarah Schnurr <[email protected]>
On 10/16/18 5:44 PM, Jonathan S. Katz wrote:
> On 10/4/18 11:50 AM, Jonathan S. Katz wrote:
>> Hi,
>>
>> As part of the effort to modernize the look and feel of PostgreSQL.org
>> and associated web projects, Sarah & I have worked on applying the new
>> styles to the documentation. The main goals of the project were:
>>
>> - To have the documentation styles match that of the main website
>> - To make the documentation easier to view on mobile devices
>> - To set up the web-based documentation for future usability changes and
>> improvements
> Thank you everyone for your feedback. We launched the new documentation
> styles this morning. Please let us know if you find any issues or have
> any additional feedback.
>
> Thanks,
>
> Jonathan
>
Hi Jonathan,
Thank you for modernizing doc styles!
I have noticed a small rendering issue in the Chrome browser. If you
follow a link to a bookmark in a different page, it's hidden below the
website header. Links within the same page and section-level links
appear to work fine.
The attached screenshot illustrates the result of navigating to the
default_statistics_targetdescription from the
https://www.postgresql.org/docs/10/static/planner-stats.html page.
I have not tested this thoroughly, but I got the same result on my
smartphone in Safari, while having no issues at all in Firefox on Ubuntu.
--
Liudmila Mantrova
Technical writer at Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company
Attachments:
[image/png] links_in_chrome.png (67.5K, 3-links_in_chrome.png)
download | view image
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-16 14:44 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-22 16:14 ` Re: Proposed HTML Documentation Styles Liudmila Mantrova <[email protected]>
@ 2018-10-22 16:29 ` Alvaro Herrera <[email protected]>
0 siblings, 0 replies; 20+ messages in thread
From: Alvaro Herrera @ 2018-10-22 16:29 UTC (permalink / raw)
To: Liudmila Mantrova <[email protected]>; +Cc: Jonathan S. Katz <[email protected]>; [email protected]; Sarah Schnurr <[email protected]>
On 2018-Oct-22, Liudmila Mantrova wrote:
> I have noticed a small rendering issue in the Chrome browser. If you follow
> a link to a bookmark in a different page, it's hidden below the website
> header. Links within the same page and section-level links appear to work
> fine.
Yeah, I see this effect too and it's very confusing.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-16 14:44 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-23 22:02 ` James Cloos <[email protected]>
1 sibling, 0 replies; 20+ messages in thread
From: James Cloos @ 2018-10-23 22:02 UTC (permalink / raw)
To: Jonathan S. Katz <[email protected]>; +Cc: [email protected]; Sarah Schnurr <[email protected]>
[Catching up on pg lists.]
When I view any doc page now, before seeing the page, a huge rendering
of the logo appears; it is then replaced with the actual page.
Perhaps the pages should use a smaller png than the 900x928 is now does?
-JimC
--
James Cloos <[email protected]> OpenPGP: 0x997A9F17ED7DAEA6
^ permalink raw reply [nested|flat] 20+ messages in thread
* RE: Proposed HTML Documentation Styles
@ 2018-10-16 18:44 Alexander Romanenko <[email protected]>
2018-10-17 00:23 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Alexander Romanenko @ 2018-10-16 18:44 UTC (permalink / raw)
To: [email protected]
I am having problem with distinguishing tables from the description body
without shadows. Without a shadow, stronger border and headings, like in
old version, tables likes function parameter lists blends in with
description paragraphs.
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-16 18:44 RE: Proposed HTML Documentation Styles Alexander Romanenko <[email protected]>
@ 2018-10-17 00:23 ` Jonathan S. Katz <[email protected]>
2018-10-17 01:20 ` Re: Proposed HTML Documentation Styles Alexander Romanenko <[email protected]>
0 siblings, 1 reply; 20+ messages in thread
From: Jonathan S. Katz @ 2018-10-17 00:23 UTC (permalink / raw)
To: Alexander Romanenko <[email protected]>; [email protected]
Hi Alexander,
On 10/16/18 2:44 PM, Alexander Romanenko wrote:
> I am having problem with distinguishing tables from the description body
> without shadows. Without a shadow, stronger border and headings, like
> in old version, tables likes function parameter lists blends in with
> description paragraphs.
I went ahead and made a change to make the table section headers to
stand out more in the documentation and verified on the documentation
for all supported versions.
Thanks,
Jonathan
Attachments:
[application/pgp-signature] signature.asc (833B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 20+ messages in thread
* Re: Proposed HTML Documentation Styles
2018-10-16 18:44 RE: Proposed HTML Documentation Styles Alexander Romanenko <[email protected]>
2018-10-17 00:23 ` Re: Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
@ 2018-10-17 01:20 ` Alexander Romanenko <[email protected]>
0 siblings, 0 replies; 20+ messages in thread
From: Alexander Romanenko @ 2018-10-17 01:20 UTC (permalink / raw)
To: [email protected]; [email protected]
Thanks for the response! The change did help a bit.
I guess no hope to make shadows come back? If not, I think I can find some
browser extension that modifies <table> tag CSS for the docs domain to
include it locally.
вт, 16 окт. 2018 г. в 20:23, Jonathan S. Katz <[email protected]>:
> Hi Alexander,
>
> On 10/16/18 2:44 PM, Alexander Romanenko wrote:
> > I am having problem with distinguishing tables from the description body
> > without shadows. Without a shadow, stronger border and headings, like
> > in old version, tables likes function parameter lists blends in with
> > description paragraphs.
>
> I went ahead and made a change to make the table section headers to
> stand out more in the documentation and verified on the documentation
> for all supported versions.
>
> Thanks,
>
> Jonathan
>
>
^ permalink raw reply [nested|flat] 20+ messages in thread
end of thread, other threads:[~2018-10-23 22:02 UTC | newest]
Thread overview: 20+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-10-04 15:50 Proposed HTML Documentation Styles Jonathan S. Katz <[email protected]>
2018-10-04 16:02 ` Pavel Stehule <[email protected]>
2018-10-04 16:28 ` Alvaro Herrera <[email protected]>
2018-10-04 16:33 ` Jonathan S. Katz <[email protected]>
2018-10-04 18:23 ` Daniel Gustafsson <[email protected]>
2018-10-04 22:33 ` Jonathan S. Katz <[email protected]>
2018-10-04 16:31 ` Jonathan S. Katz <[email protected]>
2018-10-04 19:41 ` Dean Rasheed <[email protected]>
2018-10-09 01:38 ` Jonathan S. Katz <[email protected]>
2018-10-11 05:49 ` Dean Rasheed <[email protected]>
2018-10-11 07:01 ` Dean Rasheed <[email protected]>
2018-10-12 02:03 ` Jonathan S. Katz <[email protected]>
2018-10-14 10:49 ` Dean Rasheed <[email protected]>
2018-10-16 14:44 ` Jonathan S. Katz <[email protected]>
2018-10-22 16:14 ` Liudmila Mantrova <[email protected]>
2018-10-22 16:29 ` Alvaro Herrera <[email protected]>
2018-10-23 22:02 ` James Cloos <[email protected]>
2018-10-16 18:44 RE: Proposed HTML Documentation Styles Alexander Romanenko <[email protected]>
2018-10-17 00:23 ` Jonathan S. Katz <[email protected]>
2018-10-17 01:20 ` Alexander Romanenko <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox