<simpara> is somewhat like a HTML <p>, but <para> is more like a <div>. See https://tdg.docbook.org/tdg/4.5/para.html#d0e133584 for a more specific explanation.

That said, I think that currently PhD treats both pretty similar, and in practise, the documentation mostly uses <para>.

<simpara> is somewhat like a HTML <p>, but <para> is more like a <div>. See https://tdg.docbook.org/tdg/4.5/para.html#d0e133584 for a more specific explanation.

That said, I think that currently PhD treats both pretty similar, and in practise, the documentation mostly uses <para>.

I think the only important distinction is when it's inside a <note>, <warning>, etc. element. With a simpara you'll get something like:

Note: simpara content

whereas with a para you get:

Note:

Para content

Updated the comment.

Thanks!

It seems that the manual is generally sloppy regarding the term "argument", so I left it as is, but in the long run we may consider to distinguish between "parameter" and "argument" (or "formal parameter" and "actual parameter").

What even is the difference between an argument and a parameter? I've generally seen/used them interchangeably.

See https://stackoverflow.com/questions/156767/whats-the-difference-between-an-argument-and-a-parameter

Huh, I've been getting the proper order wrong then apparently, oh well TIL