Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Including a missing \documentclass and a sectioning level #124

Open
niruvt opened this issue Feb 4, 2021 · 7 comments
Open

Including a missing \documentclass and a sectioning level #124

niruvt opened this issue Feb 4, 2021 · 7 comments

Comments

@niruvt
Copy link
Contributor

niruvt commented Feb 4, 2021

In section 02 of lesson 04 (link) we have added a list of levels of sectioning, but I was surprised to see the absence of part in this list. What is the reason for excluding it?

Also in the list of sections we explain that for chapters we need to use book or report document class, but why not memoir? Is it not a standard document class?

@josephwright
Copy link
Contributor

\part doesn't really create logical structure: doesn't show up in the TOC, etc. or add to numbering. We could I guess add it to perhaps the 'more' text.

The standard classes are (minimal), article, report, book, letter and slides: the last one in particular is not
really useful today, whilst minimal is essentially a historical leftover from kernel testing. memoir isn't provided by the team, so it's not a 'standard' class, although it is widely used for books. I guess this is a question of how open-ended we want to make things.

@sieversMartin
Copy link
Contributor

\part doesn't really create logical structure: doesn't show up in the TOC, etc. or add to numbering. We could I guess add it to perhaps the 'more' text.

It does show up in the TOC ...

\documentclass{book}

\begin{document}
   \tableofcontents
   
   \part{A part}
   \chapter{A chapter}
\end{document}

@josephwright
Copy link
Contributor

I meant in that it doesn't affect the numbering: section X.Y is unaffected by which part it's in, in contrast to say a chapter.

@josephwright
Copy link
Contributor

I'm not saying we can't add \part, only that it's not quite the same as \chapter or \section.

@niruvt
Copy link
Contributor Author

niruvt commented Feb 4, 2021

LaTeX can divide up documents into quite a few levels.

This is the exact line in our tutorial and IMO \part is a valid level provided by some document classes. So I think it can be a part of this list.

About memoir I understand your point. Still as we know that it is widely used by many users and tested for a long time, it would be amazing to mention it. Of course this is just my personal opinion. Decision is up to the authors ultimately.

@josephwright
Copy link
Contributor

LaTeX can divide up documents into quite a few levels.

This is the exact line in our tutorial and IMO \part is a valid level provided by some document classes. So I think it can be a part of this list.

I'm going to see what others think before making an edit. @davidcarlisle probably has a view, and there may well be others watching/commenting too.

About memoir I understand your point. Still as we know that it is widely used by many users and tested for a long time, it would be amazing to mention it. Of course this is just my personal opinion. Decision is up to the authors ultimately.

We do have memoir and KOMA in https://www.learnlatex.org/en/lesson-05; the idea in lesson 4 was to bring in concepts gradually. If we add memoir in L4, we really have to add KOMA too, and that then gets a bit tricky for a reader to follow. It's not easy working out how to order basic ideas: they are all needed to get going, and here one could go for the opposite order.

@niruvt
Copy link
Contributor Author

niruvt commented Feb 4, 2021

I'm going to see what others think before making an edit. @davidcarlisle probably has a view, and there may well be others watching/commenting too.

Sure!

We do have memoir and KOMA in https://www.learnlatex.org/en/lesson-05; the idea in lesson 4 was to bring in concepts gradually. If we add memoir in L4, we really have to add KOMA too, and that then gets a bit tricky for a reader to follow. It's not easy working out how to order basic ideas: they are all needed to get going, and here one could go for the opposite order.

I agree. This is a good reason to not include memoir here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants