Giter VIP home page Giter VIP logo

hz-docs's Introduction

Hazelcast Platform Documentation

Build Staging yellow

This repository contains the Antora components for the Hazelcast Platform documentation.

The documentation source files are marked up with AsciiDoc.

Docs Structure

This section describes some important information about how this repository is structured:

  • The component name, version, and start page are configured in each branch’s antora.yml file.

  • The navigation for all modules is stored in the ROOT module’s nav.adoc file.

  • The docs site playbook instructs Antora to automatically build the site using content in the main branch as well as any branches that are prefixed with v/.

Release Workflow

Documentation for new releases is hosted in versioned branches that are prefixed with v/. The latest-dev content (snapshot content) is stored in the main branch.

We support documentation for the latest patch releases of minor versions. For example, content for the 5.0 version is hosted in the v/5.0 branch. This branch contains content for the latest patch release of version 5.0.

Note
 The documentation build process is triggered whenever you create a new branch with the v/ prefix, push to an existing v/ branch, or push to the main branch.

Snapshot Releases

Add the new snapshot version to the following:

Repository Branch File Fields

hz-docs

main

docs/antora.yml

  • version

  • display_version

  • full-version

  • asciidoc.attributes.page-latest-supported-java-client

hazelcast-docs

main and develop

_redirects

/hazelcast/latest-dev/*

search-config.json

  • start_urls.tags

  • start_urls.variables.version

management-center-docs

main

docs/antora.yml

asciidoc.attributes.page-latest-supported-hazelcast

Latest Releases

Add the major.minor version to the following:

Repository Branch File Fields

hz-docs

v/{major.minor version}

docs/antora.yml

  • version

  • display_version

hazelcast-docs

main and develop

_redirects

/hazelcast/latest/*

search-config.json

Create a new object in the start_urls array.

{ "url": "https://docs.hazelcast.com/hazelcast/(?P<version>.*?)/", "tags": [ "hazelcast-{major.minor version}" ], "variables": { "version": ["{major.minor version}"] }, "selectors_key": "hz" }

management-center-docs

The v/{version} branch where version is the value of the asciidoc.attributes.page-latest-supported-mc field in the docs/antora.yml file of the hz-docs repository

docs/antora.yml

asciidoc.attributes.page-latest-supported-hazelcast

Add the full version major.minor.patch to the following:

Repository File Fields

hz-docs

docs/antora.yml

  • full-version

  • asciidoc.attributes.page-latest-supported-java-client

Patch Releases

In the v/ branch for the minor version whose patch you are releasing, update the asciidoc.attributes.full-version field in the antora.yml file to the new patch version. For example, if you are releasing version 5.0.3, find the v/5.0 branch and update the asciidoc.attributes.full-version field in the antora.yml file with 5.0.3.

Note
 As soon as you push content to this branch, GitHub will trigger a new build of the site, which will include your new content.

Creating Release Branches

  1. If you are releasing a new major version, create a release branch from the main branch.

    For example, if you are releasing version 5.1, create a new release branch named 5.1 from the main branch.

  2. Update the fields mentioned in Latest Releases.

  3. Remove the prerelease: true field from the docs/antora.yml file of the hz-docs repository.

    Important
    		 If you are creating a branch for a beta release, do not remove this field.

  4. When you are ready to release, create a maintenance branch from the release branch.

    Note
    		 As soon as you push the maintenance branch to the repository, GitHub will trigger a new build of the site, which will include your new content.

  5. Make sure to delete the release branch.

    For example, if you released version 5.1, delete the 5.1 branch. This step helps to keep the repository clean of release branches.

GitHub Actions

To automate some elements of the build process, this repository includes the following GitHub Actions:

Table 1. GitHub Actions
File Description Triggers

validate-site.yml

Validates that all internal and external links are working

On a pull request to the main, archive, and v/ maintenance branches

build-site.yml

Builds the production documentation site by sending a build hook to Netlify (the hosting platform that we use)

On a push to the main branch and any v/ maintenance branches

backport.yml

Backports commits to maintenance branches

On a push to the main branch that originated from a pull request with the backport label

Contributing

If you want to add a change or contribute new content, see our contributing guide.

To let us know about something that you’d like us to change, consider creating an issue.

License

All documentation is available under the terms of a Creative Commons License

hz-docs's People

Contributors

ahmetmircik avatar angelasimms avatar avtarraikmo avatar devopshazelcast avatar emreyigit avatar fatihozer0 avatar frant-hartm avatar gbarnett-hz avatar jackpgreen avatar jakescahill avatar jameshazelcast avatar jerrinot avatar k-jamroz avatar kutluhanmetin avatar kwart avatar ldziedziul avatar mdumandag avatar mtyazici avatar oliverhowell avatar orcunc avatar pveentjer avatar rebekah-lawrence avatar seii avatar semihbkgr avatar serdaro avatar seriybg avatar shultseva avatar srknzl avatar tomaszgaweda avatar vbekiaris avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.