David Nickerson wrote:
> Hi Tommy,
> 
> Thought I'd just jot down some initial thoughts after following your 
> invitation to have a play with the new metadata tools on the model 
> repository :-) These are generally cosmetic suggestions more for your 
> consideration than any urgent requirement you need to act on...
> 

Thank you for your input :). Some of the issues are the result of making this 
page in the short time between the time of your last email and my announcement, 
but I will address them in due time.

> The formatting of author/creator/modifier/etc names leaves a bit to be 
> desired. I'd suggest following a more standard pattern and removing the 
> '|' as the separation character. For example, something like:
>       G1 O1 F1, G2 O2 F2, & G3 O3 F3; or
>       F1, G1 O1, F2, G2 O2, & F3, G3 O3
> with F=Family, G=Given, O=other names where you drop O's where they are 
> not specified or add more in where needed. You'd imagine that then names 
> specified using the vCard:FN property would more naturally slot into 
> this kind of display.
> 

Thank you for showing me how it should be displayed.  I just tossed that part 
up in about 5 minutes without given much thought to it.  I did rush it, as you 
can see ;)

> If would be good to make the PubMed ID field a link to the PubMed page 
> for the given reference.
> 

That would be useful.

> Similarly, when editing a citation it would be good to simply specify a 
> PubMed ID or DOI or something similar and have the fields populated from 
> that database.
> 

The repository we have now originally only supported PubMed ID, and the editor 
only reads data from the CellML file.  If the database has an API to achieve 
that I would be interested in seeing how that could be done, but if not I will 
put the auto-population in the back burner.

> While its hard to judge until more metadata is presented to the user, I 
> suspect the collapsing pane view is not going to be particularly easy to 
> navigate around. But I guess we can wait and see once there are some 
> more complete examples to play with. Nesting similar properties would 
> probably be a good idea (modification history, as you pointed out).
> 

If you imagine the citation and the modification history being in the same 
page, you can see the benefits.  Also, I could start by making an index at the 
top that links to the anchors that is in the heading of the various panels.  
Just an idea for now.

> In the previous framework, each piece of metadata presented to the user 
> provided a link to the corresponding CellML/MathML code in the "view 
> cellml" tab. It would be good to keep this functionality.
> 

Yup, the only issue was I don't yet have code to pull other cmeta:comment from 
the CellML file fully in place yet, but I don't imagine this being too hard to 
do.

> While I haven't followed through with any changes, I'm hoping that 
> modifying a model's name or curation level will force the editor to also 
> add modification metadata to the model? You could perhaps pre-populate 
> the modification fields based on the changes the user is making...
> 

I am working on placing the modification entry form into the metadata editing 
form if the user is uploading a new model.  Curation level is not in the 
metadata specification yet, it only lives as an attribute on the repository 
(the edit page provides that).  As for pre-populating modification fields, how 
would my code know what changes the user made to the model between the last 
version and the one she is uploading?  There is no real version tracking code 
in the repository now, certainly no way to run diff between them.

> It would be good to have a consistent interface for editing a person's 
> name. Currently when editing metadata there is a different interface for 
> the file creator, comment authors, and citation authors. I think the 
> citation author interface is the best, although possibly with all three 
> fields having equal width. And while I guess we can force people into 
> using the full vCard:N structure when they are entering data using this 
> editor it probably gets a bit tricky to also support the abbreviated 
> vCard:FN property....
> 

See below...

> In the metadata editor, there is really nothing special about the CellML 
> Model Metadata, it just happens to be "about" the cellml:model resource. 
> It would be nice to be able to use the same interface to enter the same 
> kinds of metadata about any resource in the model document. For example, 
> it is quite useful to cite a particular source(s) for a variable value 
> or a particular modification to an equation.
> 

While it wouldn't be too difficult to extend the editor to include that, I 
would think getting the basics down first before I start making further fancy 
additions, and I didn't want to start making drastic changes before I get the 
foundation solid.  The features I have completed so far pretty much mimics what 
this PMR originally had, except using a proper library that abstracts 
operations away to classes for code that is much easier to maintain and to 
extend than what was there originally.  Oh, not to mention the upload process 
is about 10 times faster now (it no longer takes about (or even over) a minute 
for PMR to upload/process a ~200 kilobyte model with loads of metadata), and 
generates correct RDF graphs that validated by W3C's RDF validator and with a 
graph that conforms to the CellML metadata specifications (I validated that 
visually).

I also don't want to write a full fledge RDF editor right off the bat, if you 
know what I mean...

Once again, thank you for your input, Andre.

Kind Regards,
Tommy.

_______________________________________________
cellml-discussion mailing list
cellml-discussion@cellml.org
http://www.cellml.org/mailman/listinfo/cellml-discussion

Reply via email to