Comments (8)
GARefSeqSet, or we can go to a Hungarian naming convention :) I think there will be encapsulation in these classes right? That will by definition will make it more modular and simple. Just my $0.02 :)
from ga4gh-schemas.
-1
Code completion like intellisense makes long names easy to handle. And implementations should be auto-generated from the schema, so hand-typing is minimal. I'd keep it as it is for 0.5.
from ga4gh-schemas.
An API name is more important than just a class that autocompletes in code. We also have to consider the urls that get exposed, the documentation that surrounds the API, how hard it is for brand new users to understand concepts, how readable a piece of sample code is after its been written, etc.
All of these examples are actually more important than how easy it is to write the code itself. As you said, there is autocomplete for most languages, so it doesn't matter as much what the class is called from that perspective.
This on the other hand:
/referencesequencesets/search
is very affected by the name of the object.
And writing good documentation on what objects mean, like this page, also benefits from simple, concise, concepts, that use consistent patterns.
from ga4gh-schemas.
Imo the schema is the best documentation, descriptive names are self explanatory. This is important during the design phase (pre 1.0) where changes are frequent and expected to be lightweight. Tracking changes in two different places is not lightweight, and from comments it seems new users spend more time fighting git than understanding the schema.
/referencesequencesets/search
- so what's wrong with this URL? Search engines should be able to index it and normal users are not supposed to type it in.
from ga4gh-schemas.
Usually "overly long verbose names" are not encouraged (i.e. BioPerl, GATK Coding Standards, etc.)
Anyway, usually in designing frameworks and APIs the most stable designs go from general to specific. If something becomes too long it means that it can modularized into super- and subclasses with appropriate encapsulation.
Why not just separate it like this - we could even have backend URL rewrites, but it would be better if it matches the actual entity-relationship model:
/sequence/sets/reference/search
/sequence/reference/sets/search
from ga4gh-schemas.
I'd be in favour of less verbose class names also, pretty much for the reasons Cassie outlined above. I guess the question to ask is, is the Sequence in ReferenceSequenceSet redundant? I.e., could a ReferenceSet be reasonably confused for something else in this general context?
from ga4gh-schemas.
I like Reference and ReferenceSet.
The alternative of RefSeq is not so good because it is an informal brand name of NCBI.
Richard
Sent from my iPhone
On 7 Jul 2014, at 09:43, Jerome Kelleher [email protected] wrote:
I'd be in favour of less verbose class names also, pretty much for the reasons Cassie outlined above. I guess the question to ask is, is the Sequence in ReferenceSequenceSet redundant? I.e., could a ReferenceSet be reasonably confused for something else in this general context?
—
Reply to this email directly or view it on GitHub.
The Wellcome Trust Sanger Institute is operated by Genome Research
Limited, a charity registered in England with number 1021457 and a
company registered in England with number 2742969, whose registered
office is 215 Euston Road, London, NW1 2BE.
from ga4gh-schemas.
I have sent you a fax message. Please check document attached.
from ga4gh-schemas.
Related Issues (20)
- Package for CRAN
- RNA expression data structure is inefficient HOT 7
- Rename repository HOT 2
- Update Release notes for the v0.6.0a10 release
- Remove created and updated timestamps from API HOT 4
- Add peer service human readable docs HOT 1
- Document maven release process HOT 1
- Move datamodel to its own repo
- Improve development.rst
- Content Type Negotiation
- Implement updated transcript effects protocol
- Deprecate reference ID in favor of reference name or accession ID HOT 1
- Recreate assay metadata HOT 2
- Update Java Protobuf Dependency to 3.1+
- protobuf java square write code-gen HOT 3
- Change booleans to enums
- Assay Metadata for Analysis object table is broken in documentation...
- GeoLocation attributes names HOT 1
- ListReferenceBasesRequest GET or POST HOT 1
- AnalysisResult scores
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ga4gh-schemas.