Migrate to new version of Gitbook?

[Frijol]

Gitbook upgraded. Need to investigate differences/implications but probably will migrate to new version.

Research to do:
https://docs.gitbook.com/what-is-new/important-differences
https://docs.gitbook.com/what-is-new/feature-highlights

[Frijol]

Playing around with the new version on my personal repos. First impressions:

• Much faster updates after push
• Doesn't feel like a build tool– can no longer access logs from deploy to debug
• So user-friendly oriented that it's hard to dig into anything. Run into shiny surface
• Does continue to produce offline/book versions of content
• Some weirdness with autogeneration of summary/titling of pages. Hard to specify with granularity because it's all done for you– so if you titled it something different from the file name, the title is removed in favor of the autogen file name. A folder got nested under one of its peer-level files rather than as itself.
• Not syncing to local very well if you edit online– changed a filename and it didn't reflect when I pulled it down
• There's a "was this page helpful" embedded at the bottom of each page– pretty strong assumption that this is docs, Gitbook! I don't get a setting to get rid of this? (I mean, I know it's docs in this case, but it's not on the personal repo where I'm testing it)

[Frijol]

Overall I'm not really into it, but I'm not sure if they're going to keep supporting "legacy" and the new stuff is not outright offensive.

Much more of a corporation look than before, this kind of messaging:

My current inclination is to not change yet (key issue is making sure the github integration still works well with local, minor issue is making sure the autogenerated summary will serve us well) – let it settle out a little longer.

If interested in switching sooner, this is probably also fine, should just take some time to check over the new version and make sure there's nothing egregious.