Skip to content

Commit 76fd238

Browse files
author
BMAD CI Fix Agent
committed
docs(site): refresh DevRail project status
1 parent ba01674 commit 76fd238

4 files changed

Lines changed: 71 additions & 0 deletions

File tree

content/_index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,8 @@ See the full [OpenClaw integration guide](/docs/getting-started/agents/#openclaw
102102

103103
Your agents don't read your conventions. They skip your linters, ignore your formatters, and commit code that fails CI. DevRail gives them one instruction and one gate -- `make check` -- that enforces every standard automatically. Same contract for your agents, your CI, and you.
104104

105+
[Current project status](/docs/project-status/) tracks the v1 release line, public repository activity, and the GitLab v0.1.0 migration baseline rollout.
106+
105107
{{% /blocks/section %}}
106108

107109
{{% blocks/section color="white" type="row" %}}
@@ -148,6 +150,7 @@ Per-language standards define which tools run, how they are configured, and what
148150
- [Quick Start Guide](/docs/getting-started/) -- Set up a new or existing project
149151
- [Standards Reference](/docs/standards/) -- Per-language tooling conventions
150152
- [Container Documentation](/docs/container/) -- How the dev-toolchain works
153+
- [Project Status](/docs/project-status/) -- Current release and migration roadmap
151154
- [Contributing](/docs/contributing/) -- Help improve DevRail
152155

153156
{{% /blocks/section %}}
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: "Project Status and GitLab Baseline"
3+
date: 2026-08-18
4+
description: "DevRail v1 remains active on the v1.12 release line, and GitLab adoption work is being normalized around a v0.1.0 migration baseline."
5+
---
6+
7+
DevRail's public docs have been quiet while the v1 release line kept moving. This update brings the site back in line with the current state of the project: the `dev-toolchain` v1.12 line is active, the latest public v1.12 tag observed is `v1.12.13`, and GitLab adoption work is now being tracked around a practical v0.1.0 migration baseline.
8+
9+
## What changed on the site
10+
11+
- Added a [Project Status](/docs/project-status/) page for the current release line, public repository map, and GitLab migration roadmap.
12+
- Linked the status page from the homepage and docs index so it is visible without digging through release posts.
13+
- Rechecked stale GitHub links in the May plugin posts and kept them pointed at their current public sources.
14+
15+
The generated [Tool Versions](/docs/container/versions/) page is still owned by the scheduled release workflow. It remains the source of truth for exact container contents when the automation publishes a new version snapshot.
16+
17+
## GitLab v0.1.0 baseline
18+
19+
The GitLab work is about making existing repositories converge on the same contract new DevRail template projects already get: a declared `.devrail.yml`, a Makefile that preserves `make check`, review templates that ask for validation evidence, and CI that runs the DevRail check path where the project supports it.
20+
21+
The public roadmap is intentionally high-level. Private repository status and migration MRs stay in the owning GitLab projects, while devrail.dev documents the contract and the migration shape.

content/docs/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Welcome to the DevRail documentation. These guides cover everything you need to
1313
## Sections
1414

1515
- **[Getting Started](/docs/getting-started/)** -- Quick start guides for new projects, retrofitting existing repos, and AI agent setup
16+
- **[Project Status](/docs/project-status/)** -- Current release line, repository activity, and GitLab migration roadmap
1617
- **[Standards](/docs/standards/)** -- Per-language reference pages for Python, Bash, Terraform, Ansible, Ruby, and universal security tools
1718
- **[Container](/docs/container/)** -- How to use the dev-toolchain container image
1819
- **[Templates](/docs/templates/)** -- How to use the GitHub and GitLab project templates

content/docs/project-status.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: "Project Status"
3+
linkTitle: "Project Status"
4+
weight: 5
5+
description: "Current DevRail release status, repository activity, and GitLab migration roadmap."
6+
---
7+
8+
DevRail v1 is stable for current adopters. The public site, templates, standards, and container documentation are maintained from the GitHub organization, while active GitLab deployments are being normalized around the same baseline files and check contract.
9+
10+
## Current Release Line
11+
12+
- Public container release line: `ghcr.io/devrail-dev/dev-toolchain:v1`
13+
- Latest public v1.12 tag observed: `v1.12.13`
14+
- Current generated tool-version page: [Tool Versions](/docs/container/versions/)
15+
- Compatibility posture: v1 remains backward-compatible; breaking language/plugin changes are reserved for v2.
16+
17+
## Public Repository Status
18+
19+
The public repositories remain the canonical open-source surfaces:
20+
21+
| Repository | Status |
22+
|---|---|
23+
| [dev-toolchain](https://github.com/devrail-dev/dev-toolchain) | Active v1 container release line |
24+
| [devrail-standards](https://github.com/devrail-dev/devrail-standards) | Canonical standards and schema source |
25+
| [devrail.dev](https://github.com/devrail-dev/devrail.dev) | Public documentation site |
26+
| [github-repo-template](https://github.com/devrail-dev/github-repo-template) | Public GitHub bootstrap template |
27+
| [gitlab-repo-template](https://gitlab.com/devrail-dev/gitlab-repo-template) | Public GitLab bootstrap template |
28+
29+
## GitLab v0.1.0 Migration Baseline
30+
31+
The GitLab migration work is focused on making existing repositories match the same operational contract as new template-based projects. The v0.1.0 baseline means a repository has, at minimum:
32+
33+
- `DEVRAIL.md` or equivalent project-facing adoption notes
34+
- `.devrail.yml` with declared languages and project settings
35+
- Makefile targets that preserve the `make check` contract
36+
- Merge request templates that ask for validation evidence
37+
- GitLab CI that runs the DevRail check path where the project can support it
38+
39+
### Roadmap
40+
41+
1. Complete baseline-ready repositories that already have the docs, Makefile, `.devrail.yml`, and merge request template pieces.
42+
2. Fill Makefile and CI gaps in repositories that already have partial DevRail adoption.
43+
3. Classify repositories with no clear DevRail signal as adopt, defer, or exempt.
44+
4. Keep public docs aligned with the internal migration pattern without publishing private repository names or infrastructure details.
45+
46+
This page is the public status note for that work. Detailed per-repository migration status stays with the owning GitLab projects.

0 commit comments

Comments
 (0)