opus icon indicating copy to clipboard operation
opus copied to clipboard

Documentation!

Open Kan18 opened this issue 6 years ago • 1 comments

A major problem with Opus is the lack of documentation for its programs and modules. The only ways to learn how to use them are to read the code or learn from somebody else. Opus should have a central documentation source for all of its features, modules, and programs. There are some ways to approach this

Idea 1 - create a "opus-docs" repository Idea 2 - add documentation on the GitHub wiki Idea 3 - create documentation in-game (using help program)

Ideas 1 or 2 could also have in-game representations by stripping the markdown then displaying it in-game

Kan18 avatar Nov 10 '19 18:11 Kan18

For programs, I am currently using the built-in help system (along with a Help UI program). Each package can supply a help directory with help files included.

For the UI API (the most complex), I have been working on an inspector program that will hopefully act as a self documenting API tool (see the latest update which contains an inspect program).

I also have some info in the Wiki on Github - the plan was to duplicate the wiki pages to help files.

kepler155c avatar Nov 13 '19 17:11 kepler155c