je-ik commented on pull request #16682:
URL: https://github.com/apache/beam/pull/16682#issuecomment-1027658934
The problem with the right navigation is that it is
a) device dependent (looks OK on mobile, has wrong indentation on desktop
browser (FF in my case)
b) the wrong indentation is caused by the fact, that "Books" do not have
sub-sections and therefore there is no icon shown. The indentation is precisely
the same for Books as for "API Reference", "Feedback and suggestions" and "How
to Contribute". The cause is the same for all, the only reason it didn't cause
the visual glitch is that the "API Reference", "Feedback" and "How to
Contribute" are last in the right menu, so the indentation does not jump back
and forth. We could put Books before API Reference, but as I mentioned, I think
that logical order should be "Articles", "Books".
The solution would have to mean we either change the indentation of all
four parts, or remove the arrow icon from all the rest. Alternatively, we could
add a sub-section to the Books, but I didn't figure out what it should be.
We might go with something like
```
## Books
### Streaming Systems
### Building Big Data Pipelines ...
```
so that the book itself would be a sub-section instead of being part of a
list. It would probably require a somewhat longer description of the book (e.g.
we could add a list of chapters) to justify the sub-section. Putting one
sentence there would feel weird from the content perspective.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
