Skip to content

Commit b1da3c3

Browse files
garlofffkr
andauthored
Enable blog and create first article. (#348)
* Enable blog and create first article. * Fix config. * Fix author * Renove old dummy. Add link. Improve wording. * Link to archived blog and content. * Update blog/2026-01-22-introducing-docs-blog.md Reads better and is more accurate, thanks. * Removed link to old web site as per fkr's suggestion. * Final typo correction. Famous last words, I know. Signed-off-by: Kurt Garloff <kurt@garloff.de> Co-authored-by: Felix Kronlage-Dammers <fkr@hazardous.org>
1 parent 4083c21 commit b1da3c3

4 files changed

Lines changed: 90 additions & 17 deletions

File tree

blog/2022-10-28-first-blog-post.md

Lines changed: 0 additions & 8 deletions
This file was deleted.
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
slug: introducing_new_blog
3+
title: Introducing A New Blog Site On Our Docs Page
4+
authors: [garloff]
5+
tags: [docusaurus, scs, community, blog]
6+
---
7+
8+
## Evolution of SCS activities
9+
10+
Previously, we had a project web site that covered many
11+
areas of work that was done in the SCS project until it was successfully completed
12+
at the end of 2024. It covered the standardization work as well as the development
13+
of the reference implementation and also had a vast collection of links and technical
14+
content, a lot of which was related to the reference implementation. For newcomers,
15+
it was somewhat hard to distill the various aspects and goals of SCS though.
16+
17+
With the end of the funded project, we split the activities into different organizations
18+
with distinct goals:
19+
20+
1. The [Forum SCS Standards](https://sovereigncloudstack.org/en/about-scs/network/) is
21+
responsible for governing the standardization process. While it pulls significant input
22+
from the various software projects that belong to the SCS ecosystem, it is neutral towards
23+
them beyond the preference for standards compliance. This reflects that there can and
24+
ideally should be several implementations for a standard.
25+
The [new website](https://sovereigncloudstack.org/) serves as an overall entrance point to
26+
Sovereign Cloud Stack with a focus on the standardization and certification.
27+
2. The SCS community consists of individuals and organizations that develop, support,
28+
test, use, or otherwise contribute to the software and standards that implement and
29+
codify SCS. The community elects a [project board](https://docs.scs.community/standards/scs-0005-v2-project-governance)
30+
that organizes and motivates contributions. The work of the community is mainly visible
31+
on the [Documentation web site](https://docs.scs.community) and the
32+
[github site](https://github.com/SovereignCloudStack/).
33+
34+
## Blog articles
35+
36+
Blog articles with technical content relating to a specific implementation (or a set
37+
of implementations) are not a great fit for Forum's web site.
38+
The good news is that the SCS project's rich
39+
[Documentation site](https://docs.scs.community/) is architected in a way that
40+
it assembles documentation from various places. Unlike the Forum, it does not need
41+
to prioritize neutrality as top priority, but benefits and prefers those projects
42+
that contribute useful content to it.
43+
44+
We have decided to use docusaurus' blog feature to publish blog articles
45+
[here](https://docs.scs.community/blog/). We appreciate contributions.
46+
47+
## Old blog content
48+
49+
The blog content from the old web site has been migrated over into the
50+
[archive on the new site](https://sovereigncloudstack.org/en/community_blog/). You
51+
can also find the other types of community news [there](https://sovereigncloudstack.org/en/community-news/).
52+
53+
Some news that might fit the Blog category have also been published in the
54+
[main news section](https://sovereigncloudstack.org/en/insights/news/) on the new web site.

blog/authors.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ itrich:
1212

1313
garloff:
1414
name: Kurt Garloff
15-
title: CEO @ SCS
15+
title: CEO @ S7n Cloud Services, former CTO SCS
1616
url: https://github.com/garloff
1717
image_url: https://github.com/garloff.png
1818

1919
fkr:
2020
name: Felix Kronlage-Dammers
21-
title: Product Owner @ SCS
21+
title: Leader Forum SCS-Standards
2222
url: https://github.com/fkr
23-
image_url: https://github.com/fkr.png
23+
image_url: https://github.com/fkr.png

docusaurus.config.js

Lines changed: 33 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,31 @@ const config = {
3434
editUrl: 'https://github.com/SovereignCloudStack/docs/tree/main/'
3535
},
3636
blog: {
37+
path: './blog',
38+
routeBasePath: 'blog',
39+
// Author display
3740
showReadingTime: true,
38-
editUrl: 'https://github.com/SovereignCloudStack/docs/tree/main/'
41+
blogSidebarTitle: 'Recent posts',
42+
blogSidebarCount: 10,
43+
// Post metadata
44+
blogTitle: 'SCS Community Blog',
45+
blogDescription:
46+
'Insights on cloud sovereignty, open infrastructure, and the Sovereign Cloud Stack',
47+
// Authors
48+
authorsMapPath: 'authors.yml',
49+
// RSS/Atom feeds
50+
feedOptions: {
51+
type: 'all', // 'rss' | 'atom' | 'json' | 'all'
52+
title: 'SCS Community Blog',
53+
description:
54+
'Latest articles from the Sovereign Cloud Stack community',
55+
copyright: `Copyright © ${new Date().getFullYear()} Sovereign Cloud Stack`,
56+
language: 'en'
57+
},
58+
// Post URLs
59+
postsPerPage: 10,
60+
// Edit links (important for contributions!)
61+
editUrl: 'https://github.com/SovereignCloudStack/docs/edit/main/'
3962
},
4063
theme: {
4164
customCss: [require.resolve('./src/css/custom.css')]
@@ -103,7 +126,6 @@ const config = {
103126
'./src/plugins/docusaurus-plugin-matomo-analytics/index.js',
104127
'./src/plugins/docusaurus-plugin-global-data/index.js'
105128
],
106-
107129
themeConfig:
108130
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
109131
({
@@ -141,6 +163,11 @@ const config = {
141163
href: 'https://github.com/SovereignCloudStack/docs',
142164
label: 'GitHub',
143165
position: 'right'
166+
},
167+
{
168+
to: '/blog',
169+
label: 'Blog',
170+
position: 'left'
144171
}
145172
]
146173
},
@@ -172,10 +199,10 @@ const config = {
172199
{
173200
title: 'More',
174201
items: [
175-
// {
176-
// label: 'Blog',
177-
// to: '/blog'
178-
// },
202+
{
203+
label: 'Blog',
204+
to: '/blog'
205+
},
179206
{
180207
label: 'GitHub',
181208
href: 'https://github.com/SovereignCloudStack/docs'

0 commit comments

Comments
 (0)