Page 1 of 1

Documentation

Posted: 05 Jun 2019 00:56
by Ron Melby
I see some smail bits of documentation of code here and there. and understanding I have spent my life in bigger iron and all this evironment is new to me...

What is the frontrunner or THEESTANDARD documentation tool in LUA, is it LDOC (I see a lot of @s) or some of the other many tools?
I see ColeValleyGirl does CHM files, is there a CHM editor that is the best, or how are they easily made?

Anyone really understand and use LUArocks? I see a lot of interesting (when talked about) code on github, but dont understand the packaging, and some of the most interesting looks schleckt. dont understand how to use it.

is there a code profiler for LUA thats pretty sharp?

Re: Documentation

Posted: 05 Jun 2019 07:28
by ColeValleyGirl
I use CHM for User Documentation because I already have a very good (and very expensive) tool for creating them, and I'm pretty familiar with using it. I don't think I'd recommend it if you aren't already set up to do it.

Haven't tried ldoc so can't comment.

I've used Luarocks occasionally, to acquire install versions of useful libraries for personal use only -- can't include them in anything I make generally available, as they won't be easily available for other users. The documentation is rubbish until and unless the light dawns on a what is being described... So I don't make extensive use of it.

I don't use a profiler but would start looking for one here

Re: Documentation

Posted: 05 Jun 2019 08:28
by tatewise
For Lua Plugins intended for FH users, the documentation goes into the plugins:index|> Family Historian Plugins under the End User Guide in Plugin Help and Advice for published Plugins, or Work In Progress Plugins under development, or later under the Developer Guide for Code Snippets useful in Plugins. But there are no tools used to produce those guides and are up to the author to edit as necessary.

Re: Documentation

Posted: 05 Jun 2019 08:45
by ColeValleyGirl
For Lua Plugins intended for FH users, the documentation goes into the Knowledge Base > Family Historian Plugins under the End User Guide in Plugin Help and Advice for published Plugins, or Work In Progress Plugins under development
This is of course not written in stone. My documentation goes in Help (CHM) files and/or dedicated pages in the Knowledge Base.