Skip to main content

Object oriented markdown documentation

Project description

DollarDoc

Dollardoc is a unique documentation method that uses markdown and a pseudo object-oriented model to simplify documentation in complex environments. By utilizing dollar-plugins, dollardoc provides a featurefilled documentation method, while still being lightweight and straightforward.

Initially designed with system architecture documentation in mind, dollardoc can be easily generalized for other documentation purposes.

Getting Started

To begin using dollardoc, set up a base Python project that installs the dollardoc dependency. You can also use the dollar-project-boilerplate project, which will provide you with a quick start.

...Chapter under development

Installation

...Chapter under development

Creating Your First Documentation File

...Chapter under development

Building the Documentation

...Chapter under development

Dollar Syntax Documentation

...Chapter under development

Outputs Supported

Currently, this project only supports output for markdown files.

Future of the Project

  • Syntax specification

    • An outline of the syntax specification is currently in progress.
  • Better error handling

    • Improve feedback from error messages by providing the row number in dollar-files.
  • Support for tags

    • Add the ability to create indirect links between different pages using tags. This simplifies the process of linking related documentation pages without requiring the creation of entire new pages.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dollardoc-0.2.0.tar.gz (33.7 kB view hashes)

Uploaded Source

Built Distribution

dollardoc-0.2.0-py3-none-any.whl (46.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page