-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Konstantin,
On 3/25/19 17:41, Konstantin Kolinko wrote:
> My main concern is that the documentation is printable and is easy
> to use as a reference document.
>
> 1) Not being able to print is a show-stopper. (Really.) Anything
> else is just a personal preference.
@media print {
...
}
Ought to be able to handle any changes required for print media. The
menus never have to print. Never. Because they will never be navigable
on paper. So they can just be removed. Horizontal, vertical, 3D,
zooming, it doesn't matter. Just remove them when then are printed and
it's not an issue.
The main body of the content is still a wall of text from top to
bottom. That should render just fine on a printer on in PDF.
> 2) Left-side menu allows to navigate to a needed page with a
> single click. I really like this feature of this menu.
Unless you scroll too far down the page. I've always been irritated
about this "feature" of the Tomcat documentation. Once you scroll away
from the menu, it's no longer "one click away". So if it could "stick"
to the top of the window (horizontal) or never scroll completely off
the top of the page, that would be a nice improvement.
>> It utilizes the Bootstrap 4 framework and is very trendy.
>
> One announcement that made a big impression for me in year 2018 was
> this one: https://twitter.com/mislav/status/1022058279000842240
> "We’re finally finished removing jQuery from http://GitHub.com
> frontend" [...]
IMO we should avoid javascript at all costs. Almost everything worth
doing can currently be done with CSS.
Bootstrap can use jQuery, but it doesn't have to.
> Regarding concerns raised in a subsequent thread on this topic
> "Tomcat Website Redesign" thread
> https://www.mail-archive.com/dev@tomcat.apache.org/msg132281.html
>
>> a) Do nothing, i.e. keep the website as-is [1] for now
>>
>> [...] IMO option (a) is not good because the site is very
>> outdated and not mobile friendly. Many users nowadays view sites
>> on their phones and/or tablets, which a modern design can
>> address.
>
> The current site was redesigned several years ago. (See the log
> history of "/xdocs/stylesheets/tomcat-site.xsl" file) I think it
> should be mobile-friendly.
>
> What are the specific issues?
>
> Is it possible to make changes in small incremental reversible
> steps?
IMO, this *was* fairly incremental.
- -chris
-----BEGIN PGP SIGNATURE-----
Comment: Using GnuPG with Thunderbird - https://www.enigmail.net/
iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlyazfoACgkQHPApP6U8
pFiQ0A//cEB/ytCsQYwh//4WbHmXhx2AA6sjvdSPrneUKzDXM4RcC5snFyJom4oo
55hwpW1UALM9vxyvI0XFGOJ54sV7II5OUxXIecF6BZLi1Bj5bDe4aieSSIpN+hnF
MsWGSsSrl7IF38eCmT/QHuLuOjhMRxaDp9hrnE+EM+CgepyDrFXxFeHz5GCfLafq
lgu/wGFnmePS40UM/Cxw5USUFQ8ADGDS49k8l9R+deK0vN/FN2vT+W4blw3zheLj
mMBcC2quDI3/rICXUiEma6/3LYEGnilmL5mkPioyd0nQiMHLsUW/rTRqClBfVjFC
wXFuzCJwh6JFuOqjSj+jHmuSkLtq0/oUU3d0lW3O57EgpDaSdWjOOsUl3zk8v/Bt
BuVmdj6mmbJtMpXVpdiIHZ2XHk1ZnSCUjRg6h0DzuEtUIF3rVTJU9wgQBz3bc6uy
GBhSzDz1ttVEdC+09Mcv6wbMHo5xNp4G0UBEazRbtV14bxxBCF5FpRISBls/vHfL
x7AoGf/8cakr7iAsgn9LNqlF0LGmj/n5M4PnhyjmFPsfIsJJigp4uWJHbzH3qEqe
jZicpUgRq6FDosKAUrtkyAD8YD31zlvKlzrX2dsqBofHvnIERmJdjQosubVDkaVV
Wzc9kLPbBwZCCnvD0+8HryW+FuqleNtcJ3/JnyAqInqCI2reEJE=
=lW6v
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
