Personal Video Database

English => Support => Topic started by: buah on May 08, 2010, 01:57:33 am

Title: Manuals
Post by: buah on May 08, 2010, 01:57:33 am
The topic about manuals is locked, so I had to ask (to suggest) following in a separate one.

I don't know anything about xml, but I'm trying to make a skin, so I use PVD Skin Engine Manual (http://www.videodb.info/help/hlp_skins.html#sectiontags) a lot. It's a resource of a great help, indeed. Especially for us newbies.

What I found it might be helpful was to indicate default values, so it would be easier to decide whether or not to implement particular functions. Xml file also would be of a smaller size, without unnecessary (duplicated) data.

I apologize if I didn't understand that there weren't default values, and that it wasn't the way how things work.
Title: Re: Manuals
Post by: rick.ca on May 08, 2010, 10:41:33 pm
In the extremely rare case a programmer produces documentation, I'm not sure it's appropriate to comment. But since you've opened the door, some suggestions for the Export Templates Manual (http://www.videodb.info/help/hlp_export.html)...

It would be helpful if the parameters in the Field Values (http://www.videodb.info/help/hlp_export.html#movie) tables were linked to the Field Parameters (http://www.videodb.info/help/hlp_export.html#params) table. It's right below (duh!), but I forget and find myself staring blankly at a parameter like "custom"—thinking I'm supposed to know what that means (and never remembering "set to true if you want to retrieve a custom field value"). :-[

There should be a link to manual on the Templates for Plain Text Export window in the program. Not only would that be useful, it would reinforce the idea the templates provided are just examples and are meant to be modified.
inhelp
Title: Re: Manuals
Post by: buah on May 09, 2010, 01:49:28 pm
I believe that in PVD Skin Engine Manual (http://www.videodb.info/help/hlp_skins.html#sectiontags) Front Cover field is accidentally defined as <frontcover> instead <froncover>?
Title: Re: Manuals
Post by: nostra on May 10, 2010, 01:35:53 pm
Quote
What I found it might be helpful was to indicate default values, so it would be easier to decide whether or not to implement particular functions.

I'll check the manual for places where default values can/should be documented.

Quote
It would be helpful if the parameters in the Field Values tables were linked to the Field Parameters table. It's right below (duh!), but I forget and find myself staring blankly at a parameter like "custom"—thinking I'm supposed to know what that means (and never remembering "set to true if you want to retrieve a custom field value"). Embarrassed

So where exactly you want this link to be placed?

Quote
There should be a link to manual on the Templates for Plain Text Export window in the program. Not only would that be useful, it would reinforce the idea the templates provided are just examples and are meant to be modified.

OK, why not

Quote
I believe that in PVD Skin Engine Manual Front Cover field is accidentally defined as <frontcover> instead <froncover>?

Thx, I'll fix this

Title: Re: Manuals
Post by: rick.ca on May 10, 2010, 06:14:16 pm
Quote
So were exactly you want this link to be placed?

I think linking the column headings ("Parameters") would provide a sufficient indication the values in the column are explained elsewhere.
inhelp
Title: Re: Manuals
Post by: afrocuban on April 25, 2013, 12:56:34 am
Quote
What I found it might be helpful was to indicate default values, so it would be easier to decide whether or not to implement particular functions.

I'll check the manual for places where default values can/should be documented.

Any thoughts on this, yet?
Title: Re: Manuals
Post by: nostra on April 25, 2013, 06:45:58 pm
Had no time for this yet :|
Title: Re: Manuals
Post by: afrocuban on April 25, 2013, 08:33:54 pm
It's worthy enough to wait. Thanks!

In the meantime, would you please consider to answer to this (http://www.videodb.info/forum_en/index.php/topic,3337.0.html.msg16748#msg16748 date=1366853703)?