tickdoc

command
v1.4.0-rc2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 28, 2017 License: MIT Imports: 19 Imported by: 0

Documentation

Overview

Tickdoc is a simple utility similar to godoc that generates documentation from comments.

The 'tickdoc' utility understands several special comments to help it generate clean documentation.

1. tick:ignore -- can be added to any field, method, function or struct and tickdoc will simply skip it and not generate any documentation for it. Useful for ignore fields that are set via property methods.

2. tick:property -- is only added to methods and informs tickdoc that the method is a property method not a chaining method.

3. tick:embedded:[NODE_NAME].[PROPERTY_NAME] -- The object's properties are embedded into a parent node's property identified by NODE_NAME.PROPERTY_NAME.

Just place one of these comments on a line all by itself and tickdoc will find it and behave accordingly.

Example:

// Normal comments
//
// Other comments
// tick:ignore
type A struct{}

Tickdoc will format examples like godoc but assumes the examples are TICKscript instead of golang code and styles them accordingly.

Otherwise just document your code normally and tickdoc will do the rest.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL