이 프로젝트는 validatedpatterns.io에 대한 새로운 증거를 포함합니다.

Validated Patterns 문서를 작성하기 위해 컨테이너 이미지를 사용합니다. 컨테이너 이미지를 사용하여 문서 미리보기를 참조하십시오. 로컬 미리보기를 보장하는 것이 좋습니다. 배포 파이프라인에서 렌더링 된 것과 같습니다.

또는 Hugo 및 Asciidoctor를 사용하여이 사이트를 구축 할 수 있습니다.

Hugo 설치

여러 가지 방법을 사용하여 다른 플랫폼 (Linux, Windows, macOS)에 Hugo를 설치할 수 있습니다. 원하는 플랫폼에 Hugo를 설치하는 방법에 대한 자세한 내용은 Install Hugo를 참조하십시오.

Asciidoctor 설치

여러 가지 방법을 사용하여 다른 플랫폼 (Linux, Windows, macOS)에 Asciidoctor를 설치할 수 있습니다. 원하는 플랫폼에서 Asciidoctor를 설치하는 방법에 대한 자세한 내용은 Install Asciidoctor를 참조하십시오.

Hugo를 사용하는 웹 사이트 배포

Hugo를 로컬 서버로 실행할 수 있습니다.

1. 이 저장소를 로컬 저장소로 복제합니다.

2. 로컬 저장소로 변경.

3. 다음 명령을 실행:

$ hugo 서버

4. 브라우저에서 사이트 보기 http://localhost:1313/.

AI 툴링

# # # AGENTS.md의

이 저장소에는 AGENTS가 포함되어 있습니다.

Validated Patterns documentation site

This project contains the new proof-of-concept documentation site for validatedpatterns.io.

Use a container image to build the Validated Patterns documentation, locally. See Preview the documentation using a container image. This is recommended to ensure the local preview is the same as what is rendered in deployment pipelines.

Alternatively, you can build this site using Hugo and Asciidoctor.

Install Hugo

You can install Hugo on different platforms (Linux, Windows, macOS) using a number of methods. For more information on how to install Hugo on your desired platform, see Install Hugo.

Install Asciidoctor

You can install Asciidoctor on different platforms (Linux, Windows, macOS) using a number of methods. For more information on how to install Asciidoctor on your desired platform, see Install Asciidoctor.

Deploy the website locally using Hugo

You can run Hugo as a local server to test out the site.

1. Clone this repository as a local repository.

2. Change to the local repository.

3. Run the following command:

    $ hugo server
   

4. View the site on your browser at http://localhost:1313/.

AI tooling

AGENTS.md

This repository includes an AGENTS.md file that helps AI agents understand the structure, tooling, and conventions of the repository so they can make correct, buildable changes. It covers the repository layout, build commands, content authoring conventions, frontmatter schemas, and style guidelines.

AI documentation skills

The repository also includes AI agent skills for creating and reviewing documentation, located in .rulesync/skills/. These skills are synced to your editor using rulesync.

Available skills

• doc-create – Create new learn pages or pattern page sets with correct structure and style-compliant content.
• doc-review – Review existing documentation files against 24 Red Hat/IBM style guide rules, with format-aware checking for AsciiDoc and Markdown.

Prerequisites for installing AI skiils

• Node.js and npm

• rulesync installed globally:

    $ npm install -g rulesync
  

Generating skills for your editor

To sync the skills to Cursor:

    $ rulesync generate --targets cursor --features skills

To sync the skills to Claude Code:

    $ rulesync generate --targets claudecode --features skills

To sync to both at once:

    $ rulesync generate --targets cursor claudecode --features skills