The documentation should be structured better

[peter-b]

The top-level README file (which is also shown on the package page) needs to be more helpful. Specifically:

• Installation instructions need to be more prominent, and need to link to the Atom documentation for "how to install packages". Optional dependency packages need to be listed with links to the appropriate packages' pages.
• Add links to the package pages and/or documentation for Atom features that the package integrates with, including indentation, auto-completion, snippets, and linting.
• Provide very basic instructions for downloading/extracting LiveCode Server for LCS linting support.

[peter-b]

Given the feedback on the 0.6.0 release our documentation is unclear enough to basically be a bug. 😭

[montegoulding]

One option would be to include the server engine in the package so it works out of the box. It does mean maintaining that though.

[peter-b]

@montegoulding I don't think that it's very practical to include the server engine in the package 😨! I think the correct thing here is to make the server engine easier to install into the system path, possibly by proving both "Install Shell Commands" and "Install LiveCode Server" functions in the IDE somewhere. I've been meaning to file an IDE feature request for a while, so I'll make that a higher priority.

[montegoulding]

Yes please!

[peter-b]

@montegoulding livecode/livecode-ide#612