Skip to content

adam-balogh/devportal-drupal-module

 
 

Repository files navigation

CONTENTS OF THIS FILE

  • Introduction
  • Requirements
  • Installation
  • Configuration
  • Maintainers

INTRODUCTION

The Devportal module allows you to expose API reference documentation by publishing Swagger/OpenAPI files - as well as create, edit, import and publish conceptual documentation on your Drupal site.

  • For a full description of the module, visit the project page: https://www.drupal.org/project/devportal

  • To submit bug reports and feature suggestions, or to track changes: https://www.drupal.org/project/issues/devportal

  • You can add the 'FAQ' submodule to your Devportal. Questions can be grouped by topics and these topics can be used as filters on the FAQ listing page.

  • We recommend you to enable the 'Guides' submodule, which gives the ability for writers to upload docs in Markdown. It is a useful tool for content editors. Read more here.

REQUIREMENTS

This module requires only Drupal core, but optional modules can be added, such as:

INSTALLATION

  • Install the Developer portal module as you would normally install a contributed Drupal module. Visit https://www.drupal.org/node/1897420 for further information.
  • Make sure the dependencies for all the (sub)modules you want to enable are met (recursively). An example: as the devportal_api_reference submodule depends on the swagger_ui_formatter module, you should also check the README of the latter, as it might contain some useful Composer-related information about pulling in its JS dependencies.

CONFIGURATION

1. Navigate to Administration > Extend and enable the module.
2. Navigate to Administration > Devportal > Configuration to manage
   Devportal configurations.

MAINTAINERS

Supporting organizations:

About

Developer portal modules for Drupal 8

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 71.2%
  • JavaScript 16.8%
  • Shell 6.9%
  • CSS 5.0%
  • Dockerfile 0.1%