BookStack Code Mirror - website/blob - content/blog/2024/bookstack-in-2023.md

   1 +++
   2 categories = ["News"]
   3 tags = ["News"]
   4 title = "BookStack in 2023"
   5 image = "/images/blog-cover-images/cc-by-4/winter-gardens-scott-wylie.jpg"
   6 author = "Dan Brown"
   7 slug = "bookstack-in-2023"
   8 draft = false
   9 date = 2024-01-03T12:00:00Z
  10 +++
  11
  12 As we enter into 2024 I thought we'd once again look back over the past year to
  13 see how the project has evolved, in terms of both the core platform and the
  14 supporting working, including the current funding seen throughout 2023.
  15
  16 ### Project Funding
  17
  18 TODO
  19
  20 ### New Features & Enhancements
  21
  22 Within 2023 we've published 7 feature releases, with 15 patch versions for those.
  23 The below list summarizes many of the most significant additions and changes made during these releases:
  24
  25 - Notification system
  26 - System CLI for common maintenance tasks
  27 - App shortcut icon control
  28 - Default page templates within books
  29 - Comment threading
  30 - Separate dark/light mode color options
  31 - Image manager UI and behaviour overhaul
  32 - WYSIWYG editor for descriptions
  33 - Nesting support for page includes
  34 - Comments in the editor sidebar
  35 - Permission system logic revamp
  36 - Overhaul of page include back-end logic
  37 - "My account" area
  38 - Page editor design update
  39 - Basic PWA support
  40 - OIDC logout integration
  41 - Book, and shelf-book, sorting made accessible with improved UX
  42 - Updated underlying framework to Laravel 9
  43 - Updated code handling to CodeMirror 6
  44 - New Languages:
  45   - Finnish
  46   - Norwegian Nynorsk
  47   - Uzbek
  48 - API Additions:
  49   - Roles
  50   - Image gallery
  51   - Content permissions
  52   - Content ordering support
  53 - Customization:
  54   - Expanded JavaScript event hooks
  55   - Added logical theme events
  56   - Added more customization-focused partial views
  57
  58
  59 ### Website Usage & Audience Reach
  60
  61 Looking at the [BookStack website analytics](https://analytics.bookstackapp.com/bookstackapp.com)
  62 we can compare activity between 2022 and 2023 to understand year-relative growth
  63 in website usage and audience reach:
  64
  65 ![Weekly visitor chart comparing visits in 2022 to those in 2023, with detailed metrics along the top. The 2022 line shows a spike at the start of the year, but then generally sits just under that for 2023](/images/2024/01/2023-vs-2022-site-analytics.png)
  66
  67 Across visits and page-views, we can see a general average growth between 10% and 20%.
  68 This is a bit lower than the 45% growth last year, but is not bad considering I've done almost no
  69 additional outreach or marketing content pushes this year, so a ~15% growth indicates
  70 a nice steady natural rise.
  71 Last year we started the year very strong with [reaching the top of Hacker News](https://www.bookstackapp.com/blog/9000-stars-and-the-effects-of-hacker-news/),
  72 which then boosted activity for a good while, but there hasn't really been any spikes or visitor boosts
  73 from anything similar in 2023.
  74 Maybe I need to put more active effort into marketing in 2024 although it's not clear if there's a reason to do so,
  75 and slow & steady growth has it's own benefits of being more manageable and requiring less resources.
  76 To be honest, as long as we're trending in the right direction, I'm happy.
  77 I'd rather not chase numbers for the sake of it.
  78
  79 ### Videos on YouTube & PeerTube
  80
  81 Throughout 2023 I've kept up publishing videos, one for each feature release with extra videos
  82 here and there to provide guidance and/or insight for the project.
  83 Here are the [BookStack YouTube channel](https://www.youtube.com/c/BookStackApp) general stats for the year:
  84
  85 ![YouTube views line chart, with statistics as follows. Views: 94.4K, up 70% from the previous year, Watch time (hours): 6.2K, up 72% from the previous year, Subscribers: 946, up 22% from the previous year, Estimated revenue: £129.27](/images/2024/01/2023-youtube-analytics.png)
  86
  87 You may notice the estimated revenue shown there. Earlier this year the channel met the requirements for monetization
  88 so I'm now able to earn a little bit of bonus revenue from these videos.
  89 Money isn't really the target though, as it's very far from covering the effort in making this content.
  90 These videos are really about building this extra resource and community hub, while providing
  91 a means for me to celebrate and emphasise work being done for the project.
  92 Folks dunk on YouTube comments as being a toxic place, but generally the feedback I get is
  93 wonderfully wholesome which feeds my motivation for the project.
  94
  95 As you can see from the other stats, we've generally had good growth overall, even as
  96 I recently promote the YouTube content less in favour of the [PeerTube alternative I set-up](https://www.bookstackapp.com/blog/bookstack-on-foss-video/).
  97 I've been meaning to play around with shorts, just to provide quick summaries for releases, but my recording flow & format doesn't really make this easy.
  98
  99 The usage of the [BookStack PeerTube channel](https://foss.video/c/bookstack/videos) has gone well so far.
 100 Views and usage is predictably a lot lower than our established YouTube presence, but I've really liked the fact
 101 we're not forcing folks to view ads, or submit to Google's privacy requirements, when sending visitors to video
 102 content from the BookStack site. Plus it's nice to be a part of the open social fediverse.
 103
 104 On the subject of video and YouTube, in August [I spotted BookStack](https://fosstodon.org/@danb/110956729212142440)
 105 used within a Linus Tech Tips video, which was pretty awesome to see.
 106 From what I could tell, it's likely an instance set up by Floatplane which LMG labs were also
 107 using at that time.
 108
 109 ### AI Impact on BookStack
 110
 111 AI has been a massive subject for this year as LLMs & image generation has exploded in use.
 112 Personally, I've found LLMs to be quite useful in some select cases, although I'm still conflicted on the
 113 the morality of the training process and their overall impact on the world.
 114 They seem to be becoming a bigger part of society though, so it's probably important to keep tabs on their use
 115 along with their co-existence and potential benefits for projects like BookStack.
 116
 117 In regard to LLM usage in BookStack, earlier this year I came across [Danswer](https://docs.danswer.dev/introduction)
 118 which I built an integration for which allowed Chat-GPT querying of your BookStack content.
 119 I talked about this more, along with a demo of this integration, [in my video here from about 4:28](https://foss.video/w/mB67n8JBBHb9mSMYUM5DED?start=4m28s).
 120 This is probably the most valuable usage of LLMs with a system like BookStack.
 121 I've also heard some other good ideas like using LLMs to generate out templates, or base page content.
 122 Another neat idea is using image generation to create book and shelf covers.
 123 Most of these desired should be possible via existing integration methods for the most part although
 124 as LLM/AI options, and the desired usages of them, evolve we may start to see areas where we can
 125 specifically provide interfaces to help these kinds of tools.
 126
 127 Outside of the core platform, we'd also seen AI's impact in our issue management, as well as in
 128 external news content for BookStack, both of which reflects the downsides of AI:
 129
 130 On issue management, I've had a couple submitted that were clearly filled out using an LLM.
 131 I don't mind a LLM used to help where it adds value, to assist user written content.
 132 Unfortunately though, in these cases, it has simply been used in feature requests to back up the request
 133 with many paragraphs of generic text that has barely a grasp of what BookStack is.
 134 These cases are a little frustrating as it just serves to waste my time, in attempting to extract any underlying intent
 135 and value. I'm having to somewhat reverse the content to their original prompt.
 136 The questions on our feature request form are to understand the value to users, not those imagined by a text generator.
 137
 138 In regard to news content, BookStack [was featured on Laravel news](https://web.archive.org/web/20231109033107/https%3A%2F%2Fp.rizon.top%3A443%2Fhttps%2Flaravel-news.com%2Fbookstack-documentation-wiki-software) which was awesome as a long-term reader of the site myself.
 139 Unfortunately when reading it was quickly clear the article was LLM generated since many of the features detailed
 140 reflected a limited grasp on understanding BookStack while some of them were just wrong & misleading.
 141 Due to these issues, I didn't feel I could celebrate or share the article as that would just propagate this incorrect content.
 142 Instead I emailed the site to notify them of the inaccuracies, with advised changes, although I had to follow that up [with a Tweet](https://twitter.com/bookstack_app/status/1722457925900280074) a few days later to prompt some action. It was then promptly updated using the text from our website.
 143
 144
 145 ### Hacks Site?
 146
 147 http://localhost:1313/blog/hacks-on-the-site/
 148
 149 ### Going into 2024
 150
 151 TODO
 152
 153 ---
 154
 155 <span style="font-size: 0.8em;opacity:0.8;">Header Image Credits: &nbsp;<span>Photo by <a href="https://commons.wikimedia.org/wiki/File:Stowe_Landscape_Gardens_Early_Winter_Morning_Frost_10.jpg">Scott Wylie (CC-BY-4)</a> - Image Modified</span></span>