From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ricardo Wurmus <rekado@elephly.net>
Subject: Re: [PATCH 3/7] gnu: Add r-biocviews.
Date: Wed, 19 Oct 2016 14:08:48 +0200
Message-ID: <87r37csfqn.fsf@elephly.net>
References: <87intxs89p.fsf@gnu.org> <877fa8m504.fsf@elephly.net>
	<87y41khfeb.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34609)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rekado@elephly.net>) id 1bwpg7-0002X1-L2
	for guix-devel@gnu.org; Wed, 19 Oct 2016 08:09:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rekado@elephly.net>) id 1bwpg6-0005Xf-RR
	for guix-devel@gnu.org; Wed, 19 Oct 2016 08:09:03 -0400
In-reply-to: <87y41khfeb.fsf@gnu.org>
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel/>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
Sender: "Guix-devel" <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
To: Roel Janssen <roel@gnu.org>
Cc: guix-devel@gnu.org


Roel Janssen <roel@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