Contribute as a writer
User documentation is essential to make the plugin approachable for all types of users. This page provides an introduction where documentation content exists and how it is structured.
With this knowledge you can choose the matching how-to to change the content you need to change.
The documentation for this plugin is hosted on the plugin’s homepage https://intellij-asciidoc-plugin.ahus1.de/
It has the following areas:
- Start page
All files related to the start page are in the Git repository https://github.com/ahus1/intellij-asciidoc-plugin.ahus1.de in the folder startpage. That folder contains both the content (look for AsciiDoc files with the extension .adoc) plus several theme and assets related files. The start page is built with the Jekyll static site generator.
All documentation content on the website is next to the plugin’s code at https://github.com/asciidoctor/asciidoctor-intellij-plugin in the sub-folder doc. The theme for this site is in the Git repository https://github.com/ahus1/intellij-asciidoc-plugin.ahus1.de in the folder _antora. The user’s guide and the contributor’s guide a build with the Antora documentation site generator.
- Configuration files for hosting
The plugin’s homepage is hosted on Netlify. Configuration files for hosting are in https://github.com/ahus1/intellij-asciidoc-plugin.ahus1.de. Files like netlify.toml, build.sh and redirects instruct Netlify how to build and publish this site. A sub-folder lambda contains scripts to notify the maintainers of successful and unsuccessful deploys.