Re: which document class?

[Paul A. Rubin]

On 04/12/2018 06:48 AM, Dr Eberhard Lisse wrote:

You NEVER use the simple article class.  You ALWAYS use the KOMA Script
Article.

It does everything the simple class does, and better, and more :-)-O

And more complicated.


For details, RTFM :-)-O

I agree. Shouldn't take more than a week or two. ;-)

As someone once said, better is the enemy of good enough.

Paul

Re: which document class?

[Dr Eberhard Lisse]

You NEVER use the simple article class.  You ALWAYS use the KOMA Script
Article.

It does everything the simple class does, and better, and more :-)-O

For details, RTFM :-)-O


el

On 11/04/2018 16:28, Paul A. Rubin wrote:
> On 04/10/2018 07:41 AM, Aaron Brülisauer wrote:
>> Hello
>>
>> Right now I'm still reading the Tutorial and I reached the section
>> "Document Classes". I have tried multiple ones with my
>> "first_document.lyx".
>> I'll have to write a documentation for system engeneer degree. I have to
>> documentate a installation and configuration of a document sync solution
>> (Nextcloud). I'm new to LyX and don't know much about LateX. What class
>> would you choose? It should just do the work and nothing more. Simple,
>> easy to use. The right thing for a beginner.
>> I have found some Classes which look like something I could use: Report,
>> Paper, Article.
>> What are "KOMA-script-"?
>>
>> Salutations
>> Aaron
>>
> The simplest class to use is Article. I always start with that. If you
> need to have chapters, though, Article won't work. In that case, you can
> try Report or Book.
> 
> Paul
> 
> 

Re: which document class?

[Steve Litt]

On Tue, 10 Apr 2018 13:41:52 +0200
Aaron Brülisauer  wrote:

> Hello
> 
> Right now I'm still reading the Tutorial and I reached the section
> "Document Classes". I have tried multiple ones with my
> "first_document.lyx". I'll have to write a documentation for system
> engeneer degree. I have to documentate a installation and
> configuration of a document sync solution (Nextcloud). I'm new to LyX
> and don't know much about LateX. What class would you choose? It
> should just do the work and nothing more. Simple, easy to use. The
> right thing for a beginner. I have found some Classes which look like
> something I could use: Report, Paper, Article.
> What are "KOMA-script-"?
> 
> Salutations
> Aaron
> 

If you're writing a book-like thing, I'd highly recommend the Book
document class over stuff like Memoir and Koma. My experience is that
Memoir and Koma are nice at first, but start conflicting with stuff
when you go to further customize your Document Class.

If you learn the Book class thoroughly, you'll get to the point where
you can make layout files to modify and add what you need for your
particular book.

I used Memoir as the basis for my 2007 "Twenty Eight Tales of
Troubleshooting", and had so much trouble that from then on I made it a
policy to base all my books off the Book document class, and modify it
from there.

If you're writing an article, use Article. If you're writing a letter,
use Letter (or better yet imho use LibreOffice). 

If your documentation is more than 50K words, I'd recommend the Book
class, with your own customizations as specified by those your handing
your documentation to.

SteveT

Steve Litt 
April 2018 featured book: Troubleshooting Techniques
 of the Successful Technologist
http://www.troubleshooters.com/techniques

Re: which document class?

[Paul A. Rubin]

On 04/10/2018 07:41 AM, Aaron Brülisauer wrote:

Hello

Right now I'm still reading the Tutorial and I reached the section
"Document Classes". I have tried multiple ones with my "first_document.lyx".
I'll have to write a documentation for system engeneer degree. I have to
documentate a installation and configuration of a document sync solution
(Nextcloud). I'm new to LyX and don't know much about LateX. What class
would you choose? It should just do the work and nothing more. Simple,
easy to use. The right thing for a beginner.
I have found some Classes which look like something I could use: Report,
Paper, Article.
What are "KOMA-script-"?

Salutations
Aaron

The simplest class to use is Article. I always start with that. If you 
need to have chapters, though, Article won't work. In that case, you can 
try Report or Book.


Paul

Re: which document class?

[Rich Shepard]

On Tue, 10 Apr 2018, Aaron Brülisauer wrote:


I'll have to write a documentation for system engeneer degree. I have to
documentate a installation and configuration of a document sync solution
(Nextcloud). ... What class would you choose? ... at are
"KOMA-script-"?


Aaron,

  To answer your last question first, the KOMA-script classes provide much
greater flexibility for customization than do base classes. For a beginning
user I suggest picking Report (standard class); you can always change the
class later if you want to.

  There are three class categories that are most commonly used: Articles,
Books, and Reports.

  The article class is what you'd use if you were publishing your
documentation in a scientific journal or general audience magazine. When you
write a long book, with parts, chapters, and other subdivisions you'd use
the book class. In between those two extremes is the report class, which
is most appropriate for your documentation.

  You might have chapters such as Introduction, Configuration, and Backup
each with its own set of sections.

  Start your document as a report and define all the parts: chapters,
sections, subsections, etc. This is your structural outline of what you want
to have included. When you're happy with this, start filling in the content
from the top down. As you need additional input (figures, tables,
references, etc.) look at the manuals to learn about them and ask here for
clarification.

  Best way to learn is with your own document because that puts everything
in a context to which you can easily relate.

Good luck,

Rich