eclipse-che/blog

Eclipse Che Blog

How to submit and review a new blog post

Add a new file in _posts folder. Images go in assets/img/<blog-subfolder>. Test to see if everything looks good. Submit a pull request and ping reviewers on mattermost to get it approved.

How to test a blog post

Before opening a 'pull request' you may want to see how the blog post renders with Jekyll.

locally

Using docker or Podman:

From the root directory of the repository:

$ docker run --rm -it -p 4000:4000 -p 35729:35729 -v $(pwd):/projects quay.io/eclipse/che-blog:next jekyll serve --incremental --watch --host 0.0.0.0 --livereload --livereload-port 35729

Content is available at http://localhost:4000

online

Open the devfile on a che server instance running DevWorkspaces: (devfile v2)

https://che-host#https://github.com/eclipse-che/blog

Vale and AsciiDoc Visual Studio Code extensions will report problems directly in the editor

How to review a blog post

Click on the surge check and browse the content online

blog's Issues

DevWorkspace articles publishing planning

We want to publish the blog posts at spaced dates, with a regular cadence, rather then publishing them as soon as the PR is approved. Here is a provisional publishing date planning.

⚠️ Those blog posts can be transformed in a che-docs article as soon as they are approved. The blog PR should be merged on publication date (Date in the table below).

Status for the blog posts are:

• - (not started)
• Draft (started but not completed)
• Ready (completed and ready for review)
• Approved (approved for publication)
• Published (article is published on Che blog and cited by Che twitter account)

Guides are:

• AG - Administration Guide
• CG - Contribution Guide (upstream only)
• EG - Extensions Guide (upstream only)
• IG - Installation Guide
• UG - User Guide

Guide	Title	Status	Date	Author	Reviewer	PR	Article	Tweet
UG	Start a workspace by entering a URL	Published	2021-12-20	@benoitf	@max-cx @themr0c	#13	link	tweet
UG/CG	Contributing for the first time to a project	Published	2022-01-11	@ibuziuk	@tstastna	#18	link	tweet
UG	Reviewing pull requests	Published	2022-02-16	@dkwon17	@tstastna @themr0c	#23	link	tweet
UG	Configuring git repositories	-	2022-01-31	@xbaran4	@max-cx	#24	-	-
AG/IG	Using a proxy	-	-	-	-	-	-	-
AG/IG	Installing your own TLS certificate	-	-	-	-	-	-	-
AG/IG	Configuring authorization, adding and removing users	-	2022-02-07	@sparkoo	-	-	-	-
AG/IG	Capacity planning	-	2022-02-14	-	-	-	-	-
AG/UG	Best practices to define, create and manage workspaces	-	2022-02-21	-	-	-	-	-
AG/UG	DevWorkspace migration guide	-	2022-02-28	-	-	-	-	-
UG	Transition to a desktop IDE	-	2022-03-07	-	-	-	-	-
AG/UG	Setting up training and workshop environments	-	2022-03-14	-	-	-	-	-
?	Workspace side architecture (and startup flow)	-	2022-03-21	-	-	-	-	-
UG	Building container images from within a workspace	-	2022-03-28	@l0rd	-	-	-	-
AG/UG/EG	Add VS Code extensions (included or not in the plugin registry)	-	2022-04-04	-	-	-	-	-
?	Comparing Che with GitHub CodeSpaces and GitPod	-	2022-04-11	-	-	-	-	-