[Open-bio-l] Fwd: [Root-l] Source Code page on OBF wiki

[Dan Bolser]

On 6 March 2011 21:50, Chris Fields <cjfields at illinois.edu> wrote:
> On Mar 6, 2011, at 2:57 PM, Dan Bolser wrote:
>
>> Does open bio really house all the code from all these bio projects? I
>> guess not...
>
> Depends on what you mean by 'house', all of these were present in open-bio version control (CVS/SVN) at one point, but most repos have recently migrated away from the open-bio-centric version control.  EMBOSS and a few others are still using CVS I think.
>
>> If not, I'd turn this page into a table of links to the equivalent
>> pages for the other projects.
>
> Agreed.
>
>> My own feeling is that when it comes to documentation, less is more
>> (or it should be as modular as possible). I hate it when GBrowse
>> starts telling me precisely how to install Apache and MySQL, but
>> apparently some people like it like that.
>
> GBrowse users are fairly diverse (ranging from users well-versed with SQL/Apache/etc and other not so much:).  I would rather have too much documentation, but have it be well-organized to the point where more experienced users can bypass certain instructions.

Agreed.

I think the MediaWiki documentation on www.mediawiki.org is a good
example. With tutorials, TOCs, pages for specific settings and good
use of categories. In my (limited) experience, only the bioperl wiki
comes close to this standard.

Anyway, I'm probably trolling way off topic with that last remark.


> chris
>
>> On 5 March 2011 22:11, Jason Stajich <jason.stajich at gmail.com> wrote:
>>> This is probably also a message that would be helpful to generally get
>>> members from the various projects involved.
>>>
>>> -------- Original Message --------
>>> From:   Hilmar Lapp <hlapp at drycafe.net>
>>> Subject:        [Root-l] Source Code page on OBF wiki
>>> Date:   Sat, 5 Mar 2011 13:59:49 -0500
>>> To:     Root-l <root-l at open-bio.org>
>>>
>>>
>>>
>>> This page seems highly outdated: http://open-bio.org/wiki/SourceCode
>>>
>>> I could take a stab at correcting some of the stuff, but don't even
>>> have the complete picture necessary to fix it, so if someone who does
>>> would do so that'd be great help. I'm also wondering to what extent we
>>> should trim down the information here and link to the individual
>>> project wikis instead.
>>>
>>> I got here from the BioSQL wiki which links there for instructions on
>>> obtaining source code through anonymous svn access. That doesn't apply
>>> anymore, but there also is no section on anonymously obtaining code
>>> through git. One question I'm asking myself is whether we even need to
>>> document that, given that Github explains it already.
>>>
>>> Anyone any thoughts on what we should focus on in this page?
>>>
>>>        -hilmar
>>> --
>>> ===========================================================
>>> : Hilmar Lapp -:- Durham, NC -:- hlapp at drycafe dot net :
>>> ===========================================================
>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> Root-l mailing list
>>> Root-l at lists.open-bio.org
>>> http://lists.open-bio.org/mailman/listinfo/root-l
>>>
>>> _______________________________________________
>>> Open-Bio-l mailing list
>>> Open-Bio-l at lists.open-bio.org
>>> http://lists.open-bio.org/mailman/listinfo/open-bio-l
>>>
>>
>> _______________________________________________
>> Open-Bio-l mailing list
>> Open-Bio-l at lists.open-bio.org
>> http://lists.open-bio.org/mailman/listinfo/open-bio-l
>
>