MIME-Version: 1.0
References: <489cd083-d657-1137-006f-f70b803cffda@postgresql.org>
In-Reply-To: <489cd083-d657-1137-006f-f70b803cffda@postgresql.org>
From: Pavel Stehule <pavel.stehule@gmail.com>
Date: Thu, 4 Oct 2018 18:02:48 +0200
Message-ID: 
 <CAFj8pRApOj3TNhjgN_OuuVdwAm0JUeNsZkCMh8FxcP3-01BKEw@mail.gmail.com>
Subject: Re: Proposed HTML Documentation Styles
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: pgsql-docs@lists.postgresql.org, xenophenes42@gmail.com
Content-Type: multipart/alternative; boundary="00000000000074d9530577694bc9"
Precedence: bulk

--00000000000074d9530577694bc9
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

=C4=8Dt 4. 10. 2018 v 17:50 odes=C3=ADlatel Jonathan S. Katz <jkatz@postgre=
sql.org>
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
>
>

--00000000000074d9530577694bc9
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><br><br><div class=3D"gmail_quote"><div dir=3D"ltr">=C4=8D=
t 4. 10. 2018 v=C2=A017:50 odes=C3=ADlatel Jonathan S. Katz &lt;<a href=3D"=
mailto:jkatz@postgresql.org">jkatz@postgresql.org</a>&gt; napsal:<br></div>=
<blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p=
x #ccc solid;padding-left:1ex">Hi,<br>
<br>
As part of the effort to modernize the look and feel of PostgreSQL.org<br>
and associated web projects, Sarah &amp; I have worked on applying the new<=
br>
styles to the documentation. The main goals of the project were:<br>
<br>
- To have the documentation styles match that of the main website<br>
- To make the documentation easier to view on mobile devices<br>
- To set up the web-based documentation for future usability changes and<br=
>
improvements<br>
<br>
Other than reversing how the versions are display at the top of the<br>
website, we did not change any of the documentation structure and do not<br=
>
intend to as part of this version of the project.<br>
<br>
We have created a prototype of the new styles that can be viewed here,<br>
with the credentials below:<br>
<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 <a href=3D"http://174.138.60.30/docs/" rel=3D"n=
oreferrer" target=3D"_blank">http://174.138.60.30/docs/</a><br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 pgdocs / newstyles<br>
<br>
When browsing through this site, please note:<br>
<br>
- All interactions are confined to the &quot;/docs&quot; folder<br>
- Not all of the docs are loaded and they are not all the latest<br>
versions - this is just for beta testing purposes<br>
- Search in the prototype does not work<br>
<br>
We are looking for feedback in the following areas:<br>
<br>
- Things that may have degraded the user experience, e.g. things that<br>
are difficult to read<br>
- Visual bugs and errors<br></blockquote><div><br></div><div>When I am goin=
g to document, then I see (about 0.5 sec) big PostgreSQL logo. It is not pl=
easant effect.</div><div><br></div><div>I don&#39;t like table style - midd=
le vertical line is too black</div><div><br></div><div>Used colour palette =
is maybe too red based.</div><div><br></div><div>All my notes are subjectiv=
e, just my feeling</div><div><br></div><div>Regards</div><div><br></div><di=
v>Pavel<br></div><div><br></div><div> <br></div><blockquote class=3D"gmail_=
quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1=
ex">
<br>
Our goal is to launch these changes with the upcoming major release, so<br>
we appreciate your diligence in providing helpful feedback so we can<br>
provide the best possible experience.<br>
<br>
Thanks,<br>
<br>
Jonathan<br>
<br>
</blockquote></div></div>

--00000000000074d9530577694bc9--