GTFS Style Guide - Route Organization

[Brian Ferris]

I'd like to start the clock on the following proposal to introduce an initial GTFS style guide (discussed previously).  The specific proposal is for a section on Route Organization in routes.txt, with the proposed text available here:

https://docs.google.com/a/google.com/document/d/1IG3cUIUvikFmmcg8yVLy9a51uNj3Oh9E6I0pRH0300M/edit

There has been some discussions and revisions to the proposal but I think there has been enough feedback to start the clock on officially adding this to the GTFS spec page.  If there are no major points of discussion or concern for the proposed text in the next week, I'd like to add the text to the spec page.  Deadline is April 3rd, so speak now if you have feedback.

Thanks,

Brian

On Thu, Mar 22, 2012 at 8:55 PM, Brian Ferris <bdfe...@google.com> wrote:

Duly noted.  I've opened it up to editing for anyone with the link.

On Thu, Mar 22, 2012 at 7:02 PM, Aaron Antrim <aa...@trilliumtransit.com> wrote:

On Thu, Mar 22, 2012 at 10:57 AM, Brian Ferris <bdfe...@google.com> wrote:

In Google Docs, under the "File" menu item, you should see a "See Revision History" menu item that should do the trick.

The "See Revision History" option is grayed out for me.  I assume this is true for everyone with comment-only privileges. 

--
You received this message because you are subscribed to the Google Groups "General Transit Feed Spec Changes" group.
To post to this group, send email to gtfs-c...@googlegroups.com.
To unsubscribe from this group, send email to gtfs-changes...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/gtfs-changes?hl=en.

[tompw]

This seems a senisble plan, provided it is clearly be marked as advisory/informative in the spec.

[Brian Ferris]

Since there were no major objections, I pushed the initial GTFS Style
Guide entry for routes.txt organization. You can check it out at:

https://developers.google.com/transit/gtfs/style-guide

I look forward to more spirited debate as we attempt to define
additional best-practices around GTFS ; ) It sounds like route naming
conventions is the next topic up for discussion, so get ready for some
deep questions like "When is a route short name no longer short?"

Brian