home tune search software learn abc discuss about blog Starbound/LOTRO contact  

  [abc standard: home | current | route-map | updating | proposals]

 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
abc:standard:route-map [2012/01/08 18:28]
cwalshaw [1.1 Route map for the abc standard]
abc:standard:route-map [2012/07/22 06:12]
cwalshaw
Line 1: Line 1:
-==== 1.1 Route map for the abc standard ====+==== Route-map for the abc standard ====
  
-From the discussions that emerged over 2.1 it is clear that a number of changes and enhancements are necessary for the abc standard. However, I am reluctant to do them all in one go so a proposed route map of major updates is given below.+From the discussions that emerged over 2.1 it is clear that a number of changes and enhancements are necessary for the abc standard. However, I am reluctant to do them all in one goso a proposed route-map of [[#major updates]] is given below together with some [[#​fundamental principles]].
  
-If necessary, corrections,​ clarifications and minor updates will be published as minor version numbers ​(abc 2.1.1, abc 2.1.2, etc).+If required, corrections,​ clarifications and small discrete additions to the syntax can be published as [[#minor updates]] ​(e.g. abc 2.1.1, abc 2.1.2, etc).
  
-The route map also indicates some of the discussions that are taking place (mailing list links below point to the start of the discussion - for subsequent discussion, click on the link and then scroll down the page).+=== Fundamental principles ===
  
-=== 1.1.1 Major updates ===+Abc notation has been around for many years now and so a number of principles are worth stating with regard to the development of the standard: 
 +  * Clarity, conciseness and, above all, human readability are absolutely fundamental to abc notation and any new features which are introduced must respect those precepts. 
 +  * There is now a large corpus of abc music with tens of thousands of tunes encoded in abc, including many of the major Western European collections (e.g. O'​Neills). In many ways this corpus, and the familiarity with abc built up by thousands of users, is more important than any additional syntax and so all updates must be backwards compatible with current common usage. 
 +  * Abc is above all a language for describing music and so there should be clear separation between content and any formatting information (much in the same way that css separates out formatting information from html content). 
 + 
 +=== Major updates ===
  
   * abc 2.1 - sort out ambiguities and incompatibilities in single voice tunes   * abc 2.1 - sort out ambiguities and incompatibilities in single voice tunes
Line 17: Line 22:
     * see, for example, message [[http://​tech.groups.yahoo.com/​group/​abcusers/​message/​4371|4371]] and subsequent discussions     * see, for example, message [[http://​tech.groups.yahoo.com/​group/​abcusers/​message/​4371|4371]] and subsequent discussions
  
-== 1.1.2 Minor updates ==+==Minor updates ​===
  
-The following topics ​are under discussion on the abcusers mailing list and may be included in any version once a consensus is reached. Alternatively,​ since each topic is relatively discrete each of them could be published as a minor version number.+The following topics ​have been under discussion on the abcusers mailing list and may be included in any version once a consensus is reached. Alternatively,​ since each topic is relatively discrete each of them could be published as a minor version number.
  
   * transposition - see [[abc:​standard:​v2.1:​proposals]]   * transposition - see [[abc:​standard:​v2.1:​proposals]]
Line 26: Line 31:
   * a syntax for creating medleys of tunes using the ''​G:''​ field - see message [[http://​tech.groups.yahoo.com/​group/​abcusers/​message/​4283|4283]];​ not actually under discussion, but could be   * a syntax for creating medleys of tunes using the ''​G:''​ field - see message [[http://​tech.groups.yahoo.com/​group/​abcusers/​message/​4283|4283]];​ not actually under discussion, but could be
  
-==== 1.2 How to make changes to the standard ​===+=== How to submit proposals ​===
- +
-To propose corrections,​ clarifications and updates for the standard, please start a discussion on the [[http://​groups.yahoo.com/​group/​abcusers/​|abcusers email list]] or in the [[http://​abcnotation.com/​forums/​|forums]] (the forums make it easier to follow arguments within a specific topic, but the email list tends to have more traffic). +
- +
-Proposals are more likely to be adopted rapidly if they have: +
-  * favourable support from the abc user community (proposals that are controversial,​ or which have no support, are unlikely to be adopted); +
-  * text that can be inserted straight into the standard, and / or, indications of where the standard needs changing. +
- +
-When making a proposal, please make it clear whether you are suggesting new usage or whether your proposal refers to usage allowed by existing abc software which has not yet been incorporated into the standard. In the latter case, please indicate which software you are referring to and, if possible, how widespread the usage is. +
- +
-Finally, please do not address proposed changes (other than typos) directly to me - I don't necessarily have time to get involved in detailed one-to-one discussions,​ although I often make comments as part of the general debate.+
  
-Thank you!+See [[abc:​standard:​updating|updating the standard]] for details of how to prepare and submit proposals.
  
 [[http://​abcnotation.com/​contact|Chris Walshaw]] (Editor) [[http://​abcnotation.com/​contact|Chris Walshaw]] (Editor)
  
abc/standard/route-map.txt · Last modified: 2015/07/27 19:10 by cwalshaw
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki