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

Separate the \begin{document} from \hypertitle #735

Open
Jimvy opened this issue Sep 8, 2019 · 2 comments
Open

Separate the \begin{document} from \hypertitle #735

Jimvy opened this issue Sep 8, 2019 · 2 comments

Comments

@Jimvy
Copy link
Collaborator

Jimvy commented Sep 8, 2019

A lot of people may be misguided by the structure of the documents and the \hypertitle command: there is no visible \begin{document}, nor any command that creates the title page, so it causes some confusion as to where the preamble ends and where the document starts.
For the accustomed users, it's not a problem, as we know this little "idiosyncrasy" of the repo. For beginners, it may not be obvious.
It is possible in LaTeX (using some package which I forgot the name of) to append some commands before of after the "begin of environment" and "end of environment" commands. So it should be possible to move the title page creation code into the \begin{document}, without having the \begin{document} hidden inside the \hypertitle command.
Note: if we do this, we should of course choose another command name for this simplified \hypertitle (\HyperTitle ?), to keep things backward compatible, and not change the current documents (or only progressively).
What's your opinion? Is it worth it?

@MartinBraquet
Copy link
Collaborator

I don't think it is worth it for now.

@Peiffap
Copy link
Collaborator

Peiffap commented May 6, 2020

I think a better fix (rather than complicating things even further despite this being a minor inconvenience) would be to simply mention this in the contribution guidelines.

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