Trialling Gitbook for User Guide . . YAY!

Comments on Gitbook features

  • Menu hierarchy- expand and collapse
    @Kirsten this is what you mentioned:
    Yes, works but it does not always collapse:
    Not collapsing when:

Does collapse when:

Subchapters are working:

  • Expando Collapso within chapters
    Yes, works but with the accordion plug-in. I could not get the other plug-ins to work.

  • Custom themeing
    Not looked in yet

  • Embedded videos
    Yes, works but not with the plug-in code. You use the embedded code of the video and copy it into gitbook.

  • Multilingual
    Will be looked in soon?

  • discussion / comment feature
    Yes, works but not too convenient.
    To comment, you have to hover over the text. Then a + box appears, but it doesn’t say this is for commenting. You have to understand that yourself apparently.

  1. When clicking, you have to sign in first.

We don’t receive an email notification of someone commenting, not even if you’re a collaborator of the book.
It does show in the discussion box on the masterpage of the Gitbook userguide.
We will have to check regularly ourselves if there are new comments.
You do get an email notification when someone comments on a discussion/comment you started yourself.

  • Search tool
    Yes, works, it shows menu header, chapter header and accompanying text. You can play with the names of the paragraph headers and the menu headers, to make the search outcome more efficient (e.g. not using same header titles)