You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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?
The text was updated successfully, but these errors were encountered:
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.
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?
The text was updated successfully, but these errors were encountered: