From 3faca0802f7b9fefb5af7500c1fa0c0f7acaba64 Mon Sep 17 00:00:00 2001 From: Simon Hauser Date: Wed, 3 Mar 2021 18:14:46 +0100 Subject: docs: start documenting previewers (#574) Co-authored-by: Muhammed Zakir --- CONTRIBUTING.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'CONTRIBUTING.md') diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a4ec991..7706c09 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Documentation -is generating docs based on the tree sitter syntax tree. TJ wrote a grammar that includes the documentation in this syntax tree so we can do take this function header documentation and transform it into vim documentation. All documentation will be exported that is part of the returning module. So example: +We are generating docs based on the tree sitter syntax tree. TJ wrote a grammar that includes the documentation in this syntax tree so we can do take this function header documentation and transform it into vim documentation. All documentation that is part of the returning module will be exported. So example: ```lua local m = {} @@ -26,6 +26,9 @@ return m This will export function `a` with header documentation and the return value. Module function `b` and local function `c` will not be exported. +For a more in-depth look at how to write documentation take a look at this guide: [how to](https://github.com/tjdevries/tree-sitter-lua/blob/master/HOWTO.md) +This guide contains all annotations and we will update it when we add new annotations. + ## What is missing? The docgen has some problems on which people can work. This would happen in https://github.com/tjdevries/tree-sitter-lua and documentation of some modules here. -- cgit v1.2.3