Skip to content

Commit 0a8b603

Browse files
updated services and blog
1 parent 8c6dd69 commit 0a8b603

4 files changed

Lines changed: 153 additions & 6 deletions

File tree

‎config/_default/menus.en.toml‎

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,14 @@ pageRef = "about"
2626
weight = 5
2727

2828
[[main]]
29-
name = "Community"
29+
name = "Services"
30+
pageRef = "pages/services"
3031
weight = 6
3132

33+
[[main]]
34+
name = "Community"
35+
weight = 7
36+
3237
[[main]]
3338
parent = "Community"
3439
name = "World-Map"
@@ -42,7 +47,7 @@ pageRef = "pages/community-graph"
4247
weight = 2
4348

4449
[[main]]
45-
weight = 7
50+
weight = 8
4651
name = "More"
4752

4853
[[main]]
@@ -115,24 +120,29 @@ name = "Contact"
115120
pageRef = "pages/contact"
116121
weight = 3
117122

123+
[[footer]]
124+
name = "Services"
125+
pageRef = "pages/services"
126+
weight = 4
127+
118128

119129
[[footer]]
120130
name = "World-Map"
121131
pageRef = "pages/world-map"
122-
weight = 4
132+
weight = 5
123133

124134
[[footer]]
125135
name = "Community Graph"
126136
pageRef = "pages/community-graph"
127-
weight = 5
137+
weight = 6
128138

129139

130140
[[footer]]
131141
name = "Imprint"
132142
pageRef = "pages/imprint"
133-
weight = 6
143+
weight = 7
134144

135145
[[footer]]
136146
name = "Privacy"
137147
pageRef = "pages/privacy"
138-
weight = 7
148+
weight = 8
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: "Why Is Software Documentation Still Static? – WeAreDevelopers World Congress 2026"
3+
slug: why-is-software-documentation-still-static
4+
date: 2026-09-10
5+
draft: false
6+
authors:
7+
- André Dietrich
8+
- Jihad Hyadi
9+
categories:
10+
- News
11+
- Feature
12+
tags:
13+
- Video
14+
- AI
15+
- Interactive
16+
- Code
17+
- Charts
18+
- JavaScript
19+
- GitHub
20+
- Education
21+
- OER
22+
description: "A recap of our WeAreDevelopers World Congress 2026 talk: why documentation is still static, and how LiaScript turns Markdown into an interactive, browser-native runtime for executable docs."
23+
---
24+
25+
We had the chance to speak at the [WeAreDevelopers World Congress 2026](https://www.wearedevelopers.com/videos/2054-why-is-software-documentation-still-static-and-why-modern-browsers-deserve-better) (Virtual Stage) about a question that has bugged us for a while: why does software documentation still follow a one-way publishing pipeline — Markdown in, static HTML out — when it doesn't match how developers actually work? Reading, running, changing, observing, debugging: that loop happens somewhere else, never inside the docs themselves. Our answer is to stop treating the browser as a mere display device and start treating it as an application runtime, right there inside the Markdown.
26+
27+
## Watch the Talk
28+
29+
{{< youtube vNjeNjt52F0 >}}
30+
31+
In the talk we walk through how [LiaScript](https://liascript.github.io) turns a plain README into that kind of runtime:
32+
33+
* Converting static documentation into an executable environment, without leaving the page
34+
* Embedding and running native JavaScript — including live TensorFlow.js tensor operations and neural network training
35+
* Wiring up Chart.js for dynamic, data-bound visualizations
36+
* Using LiaScript's macro system to cut down on boilerplate
37+
* Capturing console output and handling asynchronous code cleanly
38+
* Adding interactivity through sliders and responsive data binding
39+
* Enhancing tutorials with animations and text-to-speech narration
40+
* Publishing the whole thing as a decentralized, interactive resource straight from a Git repository
41+
42+
## The Slides Are the Demo
43+
44+
True to the talk's own argument, the slides aren't a PDF — they're a LiaScript course, published as a public, CC0-licensed repository. Every code example shown live in the talk (the TensorFlow.js demos included) is in there to read, run, and reuse.
45+
46+
## Try It Yourself
47+
48+
Here are the slides in the LiveEditor — change the Markdown on the left and see the result on the right:
49+
50+
{{< liascript-show "https://raw.githubusercontent.com/andre-dietrich/We-Are-Developers-2026/main/README.md" >}}
51+
52+
<br/>
53+
54+
{{< button link="https://liascript.github.io/course/?https://raw.githubusercontent.com/andre-dietrich/We-Are-Developers-2026/main/README.md" label="Open the Interactive Slides" >}}
55+
56+
<br/>
57+
<br/>
58+
59+
{{< button link="https://github.com/andre-dietrich/We-Are-Developers-2026" label="View the Repository on GitHub" >}}
60+
61+
<br/>
62+
<br/>
63+
64+
{{< button link="https://www.wearedevelopers.com/videos/2054-why-is-software-documentation-still-static-and-why-modern-browsers-deserve-better" label="See the Talk on WeAreDevelopers" >}}

‎content/english/pages/imprint.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,3 +49,7 @@ Email:
4949
#### Credits & Disclaimer
5050

5151
Everything you see on this page is up for grabs! Use it, remix it, share it with your grandma—no copyright strings attached. If something *is* copyrighted, don’t worry, we’ll let you know with big, bold, serious-looking text (maybe even a dramatic soundtrack). Until then, feel free to get creative!
52+
53+
#### Professional Services
54+
55+
The professional LiaScript [services](/services/) (consulting, course creation, training, custom development) are offered independently by André Dietrich personally and are not provided by Technische Universität Bergakademie Freiberg.

‎content/english/pages/services.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: "Services"
3+
meta_title: "LiaScript - Services"
4+
description: "Professional consulting, course creation, training and custom development around LiaScript, offered personally by André Dietrich."
5+
draft: false
6+
---
7+
8+
Do you want to bring LiaScript into your university, school, NGO or company, but lack the time or the know-how to do it yourself?
9+
As the creator of LiaScript, I, [**André Dietrich**](/authors/andre-dietrich), offer professional services to help you introduce, create and extend interactive LiaScript courses.
10+
11+
{{< notice "info" >}}
12+
**These services are offered independently by André Dietrich personally.**
13+
They are **not** offered by, on behalf of or under the responsibility of the Technische Universität Bergakademie Freiberg, which publishes this website (see [Imprint](/imprint/)).
14+
Any agreement, contract or invoice is made directly with André Dietrich.
15+
LiaScript itself is, and will remain, free and open source.
16+
{{< /notice >}}
17+
18+
{{< button link="mailto:LiaScript@web.de?subject=LiaScript%20Services" label="Request a Quote" >}}
19+
20+
---
21+
22+
## Core Services
23+
24+
### LiaScript Consulting & Integration
25+
26+
Advice on introducing LiaScript in universities, schools, NGOs and companies, from the first pilot to rollout across the organisation.
27+
This includes integrating LiaScript into your existing learning environments and Learning Management Systems, for example through [SCORM, xAPI or IMS exports](/exporter/).
28+
29+
### Course Creation & Migration
30+
31+
Turning your existing material, such as PowerPoint presentations, PDFs, Markdown documents and other teaching resources, into interactive, reusable LiaScript courses.
32+
33+
### Training & Workshops
34+
35+
Hands-on training for teachers, developers and educational institutions: how to write, publish and further develop interactive courses with LiaScript, either on site or online.
36+
37+
### Custom Development
38+
39+
Custom LiaScript extensions, macros and [templates](/categories/template/), plus visualizations, simulations and interactive learning components tailored to your subject and audience.
40+
41+
---
42+
43+
## Additional Expertise
44+
45+
- **Publishing & Deployment:** publishing and maintaining courses on GitHub, GitLab and other open repositories.
46+
- **Interactive Learning:** quizzes, executable code, simulations, surveys and multimedia.
47+
- **Collaborative Classrooms:** collaborative classrooms and shared programming environments.
48+
- **LMS Integration:** integration into existing Learning Management Systems, including export formats such as SCORM.
49+
- **Accessibility & OER:** accessible, openly licensed learning materials built on open standards and easy to reuse.
50+
- **Technical Integration:** connecting external APIs, development environments and existing technical workflows.
51+
52+
**Areas:** Educational Consulting · Training · Corporate Training · IT Consulting · Custom Software Development · Technical Writing
53+
54+
---
55+
56+
## Get in Touch
57+
58+
Just send me an email to [**LiaScript@web.de**](mailto:LiaScript@web.de?subject=LiaScript%20Services).
59+
It helps if you briefly describe your organisation, what you want to achieve and your timeframe. I will get back to you with a proposal.
60+
61+
{{< button link="mailto:LiaScript@web.de?subject=LiaScript%20Services" label="Request a Quote" >}}
62+
63+
---
64+
65+
#### Service Provider
66+
67+
André Dietrich (independent, personal service, not affiliated with TU Bergakademie Freiberg)\
68+
Email: LiaScript@web.de\
69+
VAT ID (according to § 27a UStG): DE325619011

0 commit comments

Comments
 (0)