Tzafrir Cohen wrote: > On Tue, Sep 30, 2008 at 01:35:00PM -0400, Josiah Bryan wrote: >> Tzafrir Cohen wrote: >>> On Tue, Sep 30, 2008 at 11:32:41AM -0400, Josiah Bryan wrote: >>>> Hey All - >>>> >>>> Link to the index page: >>>> >>>> http://www.voip-info.org/wiki/view/Asterisk+Documentation >>>> >>> Why not link to the SVN instead? >> I considered that as well. My thoughts: >> >> 1) Ungoogleabelness (if thats a word :-) - since google already ranks >> voip-info.org high on search for asterisk related content, I thought the >> docs should be where the users are, not vis-a-versa. >> >> 2) Formatability - the docs are plain text in subversion, whereas >> putting the in the wiki offers the possibility for formatting and >> auto-linking as the algorithm presents itself. > > Do you intend to add that formatting in your script? They can't be > changed manually.
The script design supports plugin formatting as it stands. E.g. I can insert any formatting algorithm if anyone has any suggestions. Right now, the formatter script just does: #!/usr/bin/perl use strict; my $file = $ARGV[0]; print "~pp~\n"; print `cat $file`; print "~/pp~\n"; Any formatting can be added as desired - this was just a quick way to get the content online. >> 2) UI similarity - linking to the file on svn, for example: >> >> http://svn.digium.com/view/asterisk/branches/1.6.0/doc/callfiles.txt?view=co >> >> Brings just the plain text view, whereas putting it in the wiki offers >> the same UI as the rest of the site. > > http://svn.digium.com/svn/asterisk/branches/1.6.0/doc/callfiles.txt > > Looks better. I agree - if you're looking for the change log. However, I (if I were a first-time asterisk user) probably don't care for the change-log-esque view, I just want to read the text for myself. However, I'd be happy to add links to the svn at the bottom of the page if that is desired. Thoughts? Cheers! -josiah -- Josiah Bryan IT Manager Productive Concepts, Inc. [EMAIL PROTECTED] (765) 964-6009, ext. 224 _______________________________________________ -- Bandwidth and Colocation Provided by http://www.api-digital.com -- AstriCon 2008 - September 22 - 25 Phoenix, Arizona Register Now: http://www.astricon.net asterisk-users mailing list To UNSUBSCRIBE or update options visit: http://lists.digium.com/mailman/listinfo/asterisk-users
