accumulo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ctubbsii <...@git.apache.org>
Subject [GitHub] accumulo issue #177: Embedded user manual within site
Date Tue, 01 Nov 2016 23:00:45 GMT
Github user ctubbsii commented on the issue:

    https://github.com/apache/accumulo/pull/177
  
    Overall, I'm not convinced that it's better to have the manuals embedded into the site.
It adds complexity to the site layout, and maintenance. It also has some side-effects: Links
directly to the manual (which includes all of the links inside the manuals themselves) will
still go to the raw, unwrapped version. It also makes it harder for users to right-click (or
Ctrl-S) to save a copy of the manual.
    
    While those issues aren't insurmountable, and the windowed look does look nice enough
so far as it goes, I think maybe it's better to just open the manual in a separate window/tab.
That's a much simpler way to address the navigation issue, is a much smaller change, and requires
far less maintenance. That way, the manuals will continue to be thought of as separate, standalone
items, which are independently downloadable and portable regardless of the website.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message