If you take a look at the database documentation you will notice there has been a change. The new “Redwood” look and feel has been applied. I thought I would give my opinion, for what it is worth.
Remember, these are my first impressions.
Change is always bad!
As soon as you change something, people (like me) are going to come out of the woodwork and start criticising it. Within a week everyone will have forgotten what things used to be like, and a new steady state will be achieved.
Everything except My Oracle Support (MOS). I’ve never got used to the “new” interface, which we have probably had for a decade, and I still think it is bad… 😉
Expand (Not) All
The Expand/Collapse button only expands a single level down the hierarchy. That makes finding things in some manuals impossible. I regularly do an expand-all, then search using the browser search (CTRL+F) to find a feature or parameter. This change of behaviour is a complete disaster!
There is no way this was tested by anyone who actually uses the docs for their job. Either that, or their feedback was ignored.
The basic page is split into three columns, with a margin on each side (see here).
On the left is the index, which is similar to what we had before. The middle panel is the main bit of the text. The panel on the right is another sort-of mini index. I really don’t understand what the right panel is for. If the share links were put on the left index, the right panel could be removed entirely. The two side panels are collapsible, which is good. I get the feeling my first visit will always have an additional click to collapse the right panel.
The layout is responsive, so as you alter the width of the page some of the panels will collapse. Unfortunately the pointless right-hand panel seems to have priority over the useful left-hand panel. You quite often get this sort of look. Also, when you expand the screen again, the useful left-hand panel doesn’t reappear.
This happens to be the default when the docs are viewed on my work laptop. Yuck! You can manually correct it by collapsing the right panel and expanding the left. That’s two extra clicks. Yes. I am really so lazy that this bothers me.
The margins also expand as the page expands. At their biggest they are about 5cm (1.5 inches) on each side. That seems rather wide to me. I’ve read that most people find reading a narrower panel of text easier, but when I read the docs I like to have them wide. As a result the excessive margins annoy me. I’m sure the vast majority of people will not be bothered by them though. Once again, I am the victim of my large monitor. On a normal size screen the margins don’t seem excessive at all.
The default text size for the central column is good for me. They’ve resisted the urge to make everything big and bubbly. Technical docs are not the same as normal websites, and I prefer some moderation in text size. If people need bigger text, the browser can zoom.
The left index is possibly a little smaller than I would like on my main monitor, but when I look at it on a “normal person” monitor, or on my work laptop, it looks great. In this case I’m the victim of my excessively sized monitor. 🙂
I’m no expert on accessibility, but suffice to say the docs fail. So does my website, so I’m not in a position to criticise that much, but it does seem odd that a big redesign like this was not done with accessibility in mind.
I imagine the colour contrast on the left and right panels are not great. They are fine for me, but I see these colour contrast issues all the time, including on my own website.
In the future, please reach out the the community to get feedback on important issues like this. You have a pool of Oracle ACEs who are under NDA, who are more than willing to help with feedback! The two glaring mistakes would have been picked up really quickly if you had asked for feedback from people who actually use the docs constantly.
The expand-all capability has to be returned to the index ASAP! Some docs, specifically the reference manuals, are unusable without it. This is a massive fail!
The right-hand panel has to go, or be collapsed by default! Its only value is to waste space. Please get rid of it!
As for everything else, it’s all different but the same. Nothing to see here. 🙂