lyx_mirror/lib/doc/attic
Uwe Stöhr 9457c60d52 move README.Documentation to attic
It is outdated since many years now and we have the relevant info in the Development.lyx file
2018-02-20 20:31:00 +01:00
..
ca doc files: save them with LyX 2.3 - part 2 2017-11-19 02:21:30 +01:00
ja doc files: save them with LyX 2.3 - part 2 2017-11-19 02:21:30 +01:00
aastex6_sample.lyx doc files: save them with LyX 2.3 - part 1 2017-11-19 01:55:05 +01:00
Changelog-Tutorial-LyX_22x.txt Tutorial.lyx: add a hint 2016-05-15 19:09:10 +02:00
DocStyle.lyx doc files: save them with LyX 2.3 - part 1 2017-11-19 01:55:05 +01:00
eu_Additional.lyx doc files: review of links 2017-12-15 02:31:36 +01:00
eu_Customization.lyx doc, templates and example files: use https for links to lyx.org 2017-12-15 02:53:06 +01:00
eu_UserGuide.lyx doc, templates and example files: use https for links to lyx.org 2017-12-15 02:53:06 +01:00
id_UserGuide.lyx doc, templates and example files: use https for links to lyx.org 2017-12-15 02:53:06 +01:00
it_Customization.lyx doc files: save them with LyX 2.3 - part 1 2017-11-19 01:55:05 +01:00
it_UserGuide.lyx doc, templates and example files: use https for links to lyx.org 2017-12-15 02:53:06 +01:00
LaTeX.png Cmake export tests: Make eu_UserGuide.lyx pass the new ctest 2017-10-27 22:54:15 +02:00
pl_Additional.lyx doc files: review of links 2017-12-15 02:31:36 +01:00
R-S-statements.lyx doc files: save them with LyX 2.3 - part 1 2017-11-19 01:55:05 +01:00
README.Documentation move README.Documentation to attic 2018-02-20 20:31:00 +01:00
sk_UserGuide.lyx doc files: save them with LyX 2.3 - part 1 2017-11-19 01:55:05 +01:00

README.Documentation

by John Weiss [3/2000] jpweiss@idsi.net


================
Introduction

    The purpose of this file is *used* *to* *be* to provide a style
    sheet and helpful hints to those wishing to help with the
    LyX Documentation Project.  There's now a separate style-sheet for
    that.

    If you're actually looking for documentation, check out the "Help"
    menu.  Start by reading the Introduction.

================
Why a separate documentation project?  Can't the developers do it?

    In a word, no.  They're too busy adding features and squishing
    bugs.

    Also, g++ is far more forgiving of style changes than a human
    brain.  As long as the code is correct, g++ will happilly compile
    it, and compile it the same way from machine to machine.  Human
    brains are far less forgiving and far more individualized.  So,
    the documentation needs to all be in a uniform style, in addition
    to being grammatically correct and easily readable.  That's a
    pretty big undertaking - which is why I volunteered to
    administrate the docs back in 1997.  Since then, I've passed the
    duty of maintaining the docs on to others.

================
Helping Out

    If you'd like to contribute to the LyX Documentation Project,
    start by reading the file Intro.lyx.  It contains a description of
    the style of the documentation from a reader's perspective.  After
    that, read the LyX Documentation Style Sheet (DocStyle.lyx) and
    commit it to memory!


John Weiss
March, 2000