Этот проект содержит новый сайт документации для подтверждения концепции для validatedpatterns.io.

Используйте изображение контейнера для создания документации Validated Patterns на местном уровне. Просмотр документации с использованием изображения контейнера. Это рекомендуется для обеспечения того, чтобы локальный предварительный просмотр был таким же, как и в трубопроводах развертывания.

Кроме того, вы можете создать этот сайт с помощью Hugo и Asciidoctor.

####Установить Hugo

Установить Hugo можно на разных платформах (Linux, Windows, macOS) несколькими способами. Для получения дополнительной информации о том, как установить Hugo на желаемую платформу, см.

##Установить Asciidoctor

Вы можете установить Asciidoctor на различных платформах (Linux, Windows, macOS) с помощью ряда методов. Для получения дополнительной информации о том, как установить Asciidoctor на желаемую платформу, см.

Развернуть сайт локально с помощью Hugo

Вы можете запустить Hugo в качестве локального сервера для тестирования сайта.

1.Клонировать это хранилище как локальное хранилище.

2.Изменить местное хранилище.

3. Выполните следующую команду:

$ hugo сервер

4.Посмотреть сайт в вашем браузере по адресу http://localhost:1313/.

##Искусственный интеллект

###Агенты.md

Это хранилище включает агентов.

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