Suggestion to clarify the manual

[bertulli]

Hi all!
I was using this package and I noticed the manual is quite unclear, almost misleading about the usage of \cventry. It is said (section 3.2): "in the sections describing your education or your job experiences, you can use:

\cventry{years}{degree/job title}{institution/employer}
{localization}{optional: grade/...}
{optional: comment/job description}

where the last three arguments are optional"

The point is that the arguments are not actually optional, they are mandatory, but they can be left empty. If I try to use them as optional (not providing them), I get errors, as you can see in this TeX SE question.

Maybe the documentation can be reworded? I can do a PR if you like it.

[stephanlachnit]

Maybe the documentation can be reworded? I can do a PR if you like it.

Yes, the documentation needs to be reworked. There was some previous work at #58. Feel free to give it a try!

[bertulli]

I'd love so, but I think the repo misses some files. For instance, when I try to compose the file `moderncv_userguide.tex`, I get errors about a missing file. And actually, on line 208 I can see ``` latex \fbox{\includegraphics[angle=90,width=\textwidth]{cv_casual.pdf}} ``` What am I doing wrong? However, I made the "basic" PR, meaning that I only changed the unclear part of the manual (line 286). Is it ok? EDIT: I see now that email replies do not support MD, sorry for that

[ShadowMitia]

I haven't built the userguide yet, but I think you are missing some examples that are compiled?
You probably need this PR #54 to get the Makefile which should help you generate everything (hopefully).

[stephanlachnit]

However, I made the "basic" PR, meaning that I only changed the unclear
part of the manual (line 286). Is it ok?

Yes, thanks! Closed via #133