Git Product home page Git Product logo

managed-openshift-docs's Introduction

APPUiO Managed OpenShift :: Documentation for End-Users

This repository contains all the content hosted at https://docs.appuio.ch/managed-openshift

The content is written in AsciiDoc and rendered using Antora.

Tip

  • Writing AsciiDoc is best done using Visual Studio Code with the AsciiDoc addon.

  • For a reference what you can do with AsciiDoc, have a look at AsciiDoc Writer’s Guide.

  • Antora is capable of doing many great things with documentation. See the Antora docs to gain insights into the tooling.

Documentation structure

The documentation structure is inspired by the Divio’s documentation structure:

Tutorials (Learning-oriented)

A lesson which teaches you something. Location: docs/modules/ROOT/pages/tutorials.

How-to guides (Problem-oriented)

Step-by-step guides to achieve a goal. Location: docs/modules/ROOT/pages/how-tos.

Technical reference (Information-oriented)

Description about the inner ongoings. Location: docs/modules/ROOT/pages/tutorials.

Explanation (Understanding-oriented)

Explains the background. Location: docs/modules/ROOT/pages/explanations.

Contributing

Create a new branch to make the changes. After you’re satisfied with the changes open a Pull Request against the master branch.

Previewing Changes

To preview your changes locally, make sure you have Docker or Podman installed.

Just type make preview and open your browser at http://localhost:2020. This even provides support for live reload when working on the content. See this documentation for more information about it.

Adding a New Page

  1. Create new AsciiDoc (.adoc) file in the best matching folder according to the described structure under docs/modules/ROOT/pages/.

  2. Add the file to the navigation under docs/modules/ROOT/partials/

For removing pages just do the opposite: Remove the file and remove the entry in the navigation.

Deployment

This repository only holds Antora content, no plumbing and tooling (aka the Antora playbook.yml and Dockerfile) to build and deploy it. All pushes to the master branch trigger a GitHub action (.github/worflows/triggerci.yml) which in turn triggers the GitLab CI job to build and deploy the content using Antora.

managed-openshift-docs's People

Contributors

corvus-ch avatar debakelorakel avatar happytetrahedron avatar renovate[bot] avatar simu avatar tobru avatar

Watchers

avatar avatar avatar avatar avatar

managed-openshift-docs's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

Detected dependencies

github-actions
.github/workflows/release.yml
  • actions/checkout v4
  • mikepenz/release-changelog-builder-action v3
  • ncipollo/release-action v1
.github/workflows/triggerci.yml
  • Check this box to trigger a request for Renovate to run again on this repository

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.