unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Ricardo Wurmus <rekado@elephly.net>
To: Roel Janssen <roel@gnu.org>
Cc: guix-devel@gnu.org
Subject: Re: [PATCH 3/7] gnu: Add r-biocviews.
Date: Wed, 19 Oct 2016 14:08:48 +0200	[thread overview]
Message-ID: <87r37csfqn.fsf@elephly.net> (raw)
In-Reply-To: <87y41khfeb.fsf@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

  reply	other threads:[~2016-10-19 12:09 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-09-15 11:38 [PATCH 3/7] gnu: Add r-biocviews Roel Janssen
2016-09-19 12:46 ` Ricardo Wurmus
2016-10-19  9:11   ` Roel Janssen
2016-10-19 12:08     ` Ricardo Wurmus [this message]
2016-10-19 13:18       ` Roel Janssen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://guix.gnu.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87r37csfqn.fsf@elephly.net \
    --to=rekado@elephly.net \
    --cc=guix-devel@gnu.org \
    --cc=roel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).