Roel Janssen <r...@gnu.org> writes:

>>> +    (synopsis "Bioconductor structures for vocabularies and narratives of 
>>> +views")
>>
>> I don’t know what this means.  Does this mean “data structures”?  What
>> is a vocabulary or narrative in this case?
>
> No, it means a structured way of describing things by keywords.  It is
> an attempt at standardizing meta data to create a search function.  A
> vocabulary is a stricter set of words to use for a purpose.  So, package
> maintainers should use existing keywords when they reasonably fit
> instead of creating new keywords who's meaning is almost identical to an
> existing keyword.

Thanks for the explanation!

> Would the following synopsis and description be good?
>
>>    (synopsis "Bioconductor package categorization helper")
>>    (description "The purpose of biocViews is to create HTML pages that
>> categorize packages in a Bioconductor package repository according to 
>> keywords,
>> also known as views, in a controlled vocabulary.")

Yes, that’s much better.  Thank you!

~~ Ricardo


Reply via email to