I’m looking for feedback about how well the Notenik Knowledge Base is working for you.
I guess this is sort of a three-part question.
How well does the navigation work for you? I’m particularly interested in how well the navigational elements work while using the Web Book – especially since I’m using Notenik to do something similar for another site of mine: The Big Ideas in Software Development.
How well does the organizational scheme work for you? In terms of the way content is sectioned and labeled.
And finally, any suggestions for improving the actual content?
In regard to presentation and usability, I think that Web Books are on par with web pages generated from Texinfo documents e.g. the GNU Emacs documentation. Overall, I think that the UX of Web Books is great (and shines on The Big Ideas in Software Development page).
The only thing that I’d recommend to aid navigation is to allow readers to return to the entire table of contents from section and sub-section pages. Notice how the Emacs docs allow users to access the table of contents and an index next to the links that take them forward and backward through the documentation. The more I use Notenik, the more I find myself referring to the Knowledge Base. Being able to access every page listed more quickly would be a lot of help when I’m deep in the weeds on a given aspect of the software. This page from The Big Ideas in Software Development is a great example of what I’m referring to.
I hope to return later with more insight on the other two questions, but this is the most complete piece of feedback that I have so far.
I’m not a frequent user of the Knowledge Base but as you add new features to Notenik, I find myself relying on it to get a grasp of them. And that’s worked well for the sortable tables (wonderful new feature itself, BTW) and the text-format tag (another feature I put to use right away).
So it’s getting the job done for me, documenting what’s becoming a very powerful tool for text-based documents.