About the Lino documentation

The Lino documentation is distributed over several documentation trees, each of them targeted at different audiences.

main website

A doctree for “everybody”, including (future) site operators, stakeholders and consultants.

https://www.lino-framework.org

user guide

A doctree for end users, key users and support providers

https://using.lino-framework.org

hosting guide

A doctree for hosting providers

https://hosting.lino-framework.org

developer guide

A doctree for application developers and core developers.

https://dev.lino-framework.org

The source code of these documentation trees is published in code repositories as free content under the same licence as the source code of Lino itself. You can find the source code by clicking on the “Source code” in the footer of every web page.

Technical documentation includes topic guides, reference documentation, the changelog and others. For some applications we maintain also end-user documentation in different languages. These are independent doctrees, not a translation of the technical docs.

reference documentation

A section of documentation pages that are intermediate between developer guide and user guide.

Reference documentation is not only for developers, it can be a valuable help for support providers and motivated key users.

Reference docs contain class descriptions for database models and data views.

Reference docs are not translated like the user guide.

local help pages

A doctree that is automatically generated by a Lino site. These pages are what opens when you click the help button (?).

See also About local help pages.

site documentation

Another name for local help pages.

doctree

Abbreviation for documentation tree.

documentation tree

A stand-alone hierarchy of content pages that are rendered as a website or a book.

end-user documentation

Documentation for end users of a given Lino site. Written in the language(s) requested by the site operator.

developer documentation

Documentation written for software developers and motivated site experts. Only in English. May include tested source code snippets and part of the test suite.