Fixing issues in #721

[gregoriopellegrino]

No description provided.

[mattgarrish]

This looks fine.

Explaining the xpaths we'd need to discuss as it would take a lot of work to do. We did something similar with the publication manifest processing using details elements.

[gregoriopellegrino]

Explaining the functions of XPATH m seems a bit of a stretch, can't we refer back to the specifications?

https://www.w3.org/TR/xpath-10/#corelib

[mattgarrish]

I don't think we even need to go that far. If you don't know what xpath functions do you can look those up. I was just thinking about explaining what some of the complex xpaths are capturing, like the closest lang declaration or what the ones that use refines are looking for. I can see some of those being a challenge to follow. The understanding the variables sections only give you a very high-level description of what is captured in these cases.

[mattgarrish]

But it's also time-consuming to do and I don't know that we have the time right now to do it with everything else we want to work on.

[rickj]

Reviewed by my team. Approved.