Helpful ReplyUpdate the SONAR Reference Guide more frequently

Author
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
2015/06/25 13:22:00 (permalink)
4.83 (12)

Update the SONAR Reference Guide more frequently

Willy has requested a thread about this subject.
 
Historically, the SONAR Reference Guide (the SONAR help in pdf format) was created from a snapshot of the help for  a version of SONAR within a month or so of release. The pdf would not be updated. Instead the local chm and more recently the web-based help files would get updates. Now the  local chm and web-based help files are updated with the release of program updates. How often should the reference guide be updated?
 
 
#1
Brando
Max Output Level: -47.5 dBFS
  • Total Posts : 2776
  • Joined: 2003/11/06 11:47:20
  • Location: Canada
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/25 14:23:30 (permalink)
0
Sorry Scook - I voted before I read your post completely. I feel it should be updated "more" frequently, but understand that monthly is probably (possibly) excessive - especially if this affects resources applied to program fixes and enhancements.
That being said, I would believe that it shouldn't be a big deal to generate a pdf of the help file, should it?
No offence to Cake, but an up to date Reference Guide is more important to me than a Start Page or changes to the CCC. Just my opinion.

Brando
Cakewalk, Studio One Pro, Reaper
Presonus Audiobox 1818VSL
ASUS Prime Z370-A LGA1151, 32GB DDR4, Intel 8700K i7, 500 GB SSD, 3 x 1TB HDD, Windows 10 Pro 64
#2
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/25 14:28:51 (permalink) ☄ Helpfulby jimfogle 2016/11/02 21:56:59
0
There should be no competition for resources. The documentation group is different from the dev group.
#3
havemose
Max Output Level: -90 dBFS
  • Total Posts : 8
  • Joined: 2014/12/24 17:07:22
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/26 00:23:54 (permalink) ☄ Helpfulby jimfogle 2015/12/06 13:01:54
+8 (8)
I would very much like the Reference Guide PDF to be current. I'd like to load the PDF on my kindle and read when away from the computer. Sonar is a complex product and I would like the opportunity to study when the opportunity present itself.
With today's documentation tools, it should be trivial to generate both windows help files and PDFs from the same source material. I suggest CW makes PDF generation part of the release process for documentation.
#4
icontakt
Max Output Level: -32.5 dBFS
  • Total Posts : 4266
  • Joined: 2012/03/04 08:18:02
  • Location: Tokyo
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/26 03:19:53 (permalink)
+2 (2)
I'm not sure how often the PDF reference guide should be updated, but I definitely want the documentation group to inspect the whole manual and correct all errors in it first.

Tak T.
 
Primary Laptop: Core i7-4710MQ CPU, 16GB RAM, 7200RPM HDD, Windows 7 Home Premium OS (Japanese) x64 SP1
Secondary Laptop: Core2 Duo CPU, 8GB RAM, 7200RPM HDD, Windows 7 Professional OS (Japanese) x64 SP1
Audio Interface: iD14 (ASIO)
Keyboard Controller/MIDI Interface: A-800PRO
DAW: SONAR Platinum x64 (latest update installed)
#5
Brando
Max Output Level: -47.5 dBFS
  • Total Posts : 2776
  • Joined: 2003/11/06 11:47:20
  • Location: Canada
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/26 07:07:44 (permalink)
0
Thanks Scook (for resetting my vote)- I still think this is a "5" and revoted to reflect. Thanks for clarifying the resource situation wrt documentation.

Brando
Cakewalk, Studio One Pro, Reaper
Presonus Audiobox 1818VSL
ASUS Prime Z370-A LGA1151, 32GB DDR4, Intel 8700K i7, 500 GB SSD, 3 x 1TB HDD, Windows 10 Pro 64
#6
BobF
Max Output Level: 0 dBFS
  • Total Posts : 8124
  • Joined: 2003/11/05 18:43:11
  • Location: Missouri - USA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/26 07:20:26 (permalink)
+1 (1)
I can remember the days when paper ruled for tech manuals.  Rather than a full blown reproduction, an errata was maintained on an ongoing basis until its content was folded into the next edition of the manual.
 
With web pages being what they are, it seems this model would be particularly efficient as it would provide an immediately available resource for users AND a repository of changes needed for the next full production.  Especially considering the fluid nature of Sonar versions these days.
 
 

Bob  --
Angels are crying because truth has died ...
Illegitimi non carborundum
--
Studio One Pro / i7-6700@3.80GHZ, 32GB Win 10 Pro x64
Roland FA06, LX61+, Fishman Tripleplay, FaderPort, US-16x08 + ARC2.5/Event PS8s 
Waves Gold/IKM Max/Nomad Factory IS3/K11U

#7
BobF
Max Output Level: 0 dBFS
  • Total Posts : 8124
  • Joined: 2003/11/05 18:43:11
  • Location: Missouri - USA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/06/26 07:23:22 (permalink)
0
scook
There should be no competition for resources. The documentation group is different from the dev group.




This might be true as far as competing with resources for Sonar bugs and features, but I have to believe that the documentation people are doing *something* other than eating bagels between Sonar doc productions.  If not, then I have some cost containment measures in mind for Cakewalk. 

Bob  --
Angels are crying because truth has died ...
Illegitimi non carborundum
--
Studio One Pro / i7-6700@3.80GHZ, 32GB Win 10 Pro x64
Roland FA06, LX61+, Fishman Tripleplay, FaderPort, US-16x08 + ARC2.5/Event PS8s 
Waves Gold/IKM Max/Nomad Factory IS3/K11U

#8
mudgel
Max Output Level: 0 dBFS
  • Total Posts : 12010
  • Joined: 2004/08/13 00:56:05
  • Location: Linton Victoria (Near Ballarat)
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/07/03 08:04:34 (permalink)
0
Yes. Cut out the bagels. Go work on the hover car, board, device. See what I did there? Ha?

Mike V. (MUDGEL)

STUDIO: Win 10 Pro x64, SPlat & CbB x64,
PC: ASUS Z370-A, INTEL i7 8700k, 32GIG DDR4 2400, OC 4.7Ghz.
Storage: 7 TB SATA III, 750GiG SSD & Samsung 500 Gig 960 EVO NVMe M.2.
Monitors: Adam A7X, JBL 10” Sub.
Audio I/O & DSP Server: DIGIGRID IOS & IOX.
Screen: Raven MTi + 43" HD 4K TV Monitor.
Keyboard Controller: Native Instruments Komplete Kontrol S88.
#9
charlyg
Max Output Level: -72 dBFS
  • Total Posts : 950
  • Joined: 2015/02/27 22:10:47
  • Location: West Hills, CA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/07/03 08:23:02 (permalink)
-1 (1)
I'm a retired PC tech, and electronic tech before that. I have read tons of manuals, but frankly I would rather watch a show and tell video than slog thru another manual.
 

 
 
#10
Sir William
Max Output Level: -87 dBFS
  • Total Posts : 166
  • Joined: 2015/01/15 02:56:50
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/08/30 06:59:29 (permalink)
0
Hi. I also like to read the manual when travelling or away from my studio. One option is to use a free chm to pdf conversion software and pop the result on your kindle / reader. I admit it isn't as pretty as the manual, but it IS as up to date as you can get.

Sonar - Platinum (always up to date)
PC - Dell XPS 13 7th Gen Intel i7, 500GB SSD, 16GB RAM, 2 x 27" HD monitors, connected via a D3100 DOCKING STATION.
OS - Windows 10 x64
Interface - Focusrite Scarlett 8i6, Yamaha MG12XU

Rack FX - TC Helicon Voiceworks Plus, TC Electronics M300
MIDI - M AUDIO Keystation PRO 88, Focusrite Scarlett 8i6, Roland UM-ONE Mk 2, Yamaha MU100R
 
Microphones - sE X1, AT 2035, Neumann TLM102
Monitors - Yamaha NS7, ATH-M50 'Phones
#11
slartabartfast
Max Output Level: -22.5 dBFS
  • Total Posts : 5289
  • Joined: 2005/10/30 01:38:34
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/08/30 12:33:05 (permalink) ☄ Helpfulby jimfogle 2015/12/06 13:04:39
+4 (4)
charlyg
I'm a retired PC tech, and electronic tech before that. I have read tons of manuals, but frankly I would rather watch a show and tell video than slog thru another manual. 




And I am a read-to-absorb learner. I get virtually nothing from a video or lecture but a physical book sticks in my mind. I can read and interpret an hour of how-to video in about a fifth of the time, and the ability to look back a half page instantly if something slips by on the first run is invaluable. Looking up a forgotten or misunderstood concept in a library of videos is a hopeless task, but takes only seconds in a full text search of a pdf.
#12
pwalpwal
Max Output Level: -43 dBFS
  • Total Posts : 3249
  • Joined: 2015/01/17 03:52:50
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/09/24 12:14:13 (permalink)
0
is the online help searchable yet?

just a sec

#13
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/09/24 12:21:32 (permalink) ☄ Helpfulby pwalpwal 2015/09/24 12:56:07
0
Both the website and chm are searchable.
#14
Beepster
Max Output Level: 0 dBFS
  • Total Posts : 18001
  • Joined: 2012/05/11 19:11:24
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/12/05 13:25:22 (permalink)
-1 (1)
I think realistically every 6 months would be appropriate for a PDF update/snapshot.
 
Upvoted just because...
post edited by Beepster - 2015/12/05 13:37:17
#15
scottfa
Max Output Level: -81 dBFS
  • Total Posts : 453
  • Joined: 2005/04/23 06:25:47
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/12/05 13:40:13 (permalink) ☄ Helpfulby jimfogle 2016/06/23 20:25:12
+2 (2)
I would think that Cakewalk would want to have just one manual. So, update the local PDFs at the same time as the on line version. Have an option in the CCC to download the revised  PDF.

Intel I7 2600K (OCed to 4.0)
Gigabyte Ga-Z68X-UD3H-B3
16G Corsair 1600  Memory 4 sticks
1 SSD, 1WD 650 SATA and 1 Samsung 1G SATA    
Steinberg MR816X 
Mackie R800 Adat to the Steinberg
Windows 10 64 bit     
Sonar Platinum Lifetime
UAD-2  Solo
#16
BobF
Max Output Level: 0 dBFS
  • Total Posts : 8124
  • Joined: 2003/11/05 18:43:11
  • Location: Missouri - USA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2015/12/05 16:57:05 (permalink)
0
IIRC, the last several (two?) monthly updates have included updated docs.  If that's part of the regular routine, this FR could be marked as "Implemented"

Bob  --
Angels are crying because truth has died ...
Illegitimi non carborundum
--
Studio One Pro / i7-6700@3.80GHZ, 32GB Win 10 Pro x64
Roland FA06, LX61+, Fishman Tripleplay, FaderPort, US-16x08 + ARC2.5/Event PS8s 
Waves Gold/IKM Max/Nomad Factory IS3/K11U

#17
phil5633
Max Output Level: -87 dBFS
  • Total Posts : 154
  • Joined: 2005/08/13 17:04:29
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/06/23 16:44:07 (permalink)
0
scook
Both the website and chm are searchable.


How do I find the chm? All the links under the Help tab appear to go to the web. None appear to go to local documentation.

BillP - SONAR Platinum, MOTU 828mkII, Focusrite 18i8, Akai MPK49, Windows 10 x64, Core i7-6850K 3.60GHz, 32GB DDR4, ASUS X99-DELUXE--II MB, AMD R7 250 GPU,  Behringer ADA8000, dbx 386,  (2) Aphex 207, (2) ART TPS II, Presouns E5/E8, Avantone MixCubes, Presonus Monitor Station v2
#18
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/06/23 16:50:25 (permalink) ☄ Helpfulby phil5633 2016/06/23 17:16:15
+2 (2)
Going to the web is the default. If the PC is not connected to the web it will fall back to the local help. To force SONAR to use the local help enable "Always Use Local Help" in Preferences > File > Advanced. To see advanced settings make sure the Advanced radio button is selected at the bottom of the Preferences dialog.
#19
phil5633
Max Output Level: -87 dBFS
  • Total Posts : 154
  • Joined: 2005/08/13 17:04:29
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/06/23 16:57:01 (permalink)
0
Given that the online documentation is continuously updated, I can refer to that more often and report any issues I encounter. Some time back I started using the online documentation but ran in to trouble along the way and switched back to the pdf versions, but I don't recall what the problem was. It might have been difficulties printing excerpts that I could markup and keep at my desk I'll start relying more on the online documentation.
 
With respect to how often to update the pdf versions, I'd say as often as practical but not too often. I like having it available for use offline. Like other's I think adding features and correcting problems are more important than maintaining pdf documentation.
 
Also it's confusing to get a new copy of an old PDF file with each release. I'd prefer that the PDF file not be included in updates unless it's been updated and has a new version number.
 
Bill
 

BillP - SONAR Platinum, MOTU 828mkII, Focusrite 18i8, Akai MPK49, Windows 10 x64, Core i7-6850K 3.60GHz, 32GB DDR4, ASUS X99-DELUXE--II MB, AMD R7 250 GPU,  Behringer ADA8000, dbx 386,  (2) Aphex 207, (2) ART TPS II, Presouns E5/E8, Avantone MixCubes, Presonus Monitor Station v2
#20
phil5633
Max Output Level: -87 dBFS
  • Total Posts : 154
  • Joined: 2005/08/13 17:04:29
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/06/23 17:03:14 (permalink)
0
scook
Going to the web is the default. If the PC is not connected to the web it will fall back to the local help. To force SONAR to use the local help enable "Always Use Local Help" in Preferences > File > Advanced. To see advanced settings make sure the Advanced radio button is selected at the bottom of the Preferences dialog.


Thanks I like the Local Version. To me it's easier to navigate than the web version. I'm glad that this is continuously updated as well.
 
Bill

BillP - SONAR Platinum, MOTU 828mkII, Focusrite 18i8, Akai MPK49, Windows 10 x64, Core i7-6850K 3.60GHz, 32GB DDR4, ASUS X99-DELUXE--II MB, AMD R7 250 GPU,  Behringer ADA8000, dbx 386,  (2) Aphex 207, (2) ART TPS II, Presouns E5/E8, Avantone MixCubes, Presonus Monitor Station v2
#21
pwalpwal
Max Output Level: -43 dBFS
  • Total Posts : 3249
  • Joined: 2015/01/17 03:52:50
  • Status: offline
update reference manual 2016/10/15 11:40:30 (permalink)
0
(i thought i'd posted this already but can;t find it within the last 18 months of forum posts)
 
update the big reference guide (circa 2015) with all the update infos (forum/ezine) since then
 
ideally this would be every month with the update (it's not a big task) but could just be yearly or?

just a sec

#22
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/10/15 11:44:16 (permalink) ☄ Helpfulby pwalpwal 2016/10/15 11:52:39
0
merged
#23
BobF
Max Output Level: 0 dBFS
  • Total Posts : 8124
  • Joined: 2003/11/05 18:43:11
  • Location: Missouri - USA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/10/15 19:27:59 (permalink)
0
My latest idea:  update the pdf guide and ref.  Free downloads and make printed copies available via lulu.com

Bob  --
Angels are crying because truth has died ...
Illegitimi non carborundum
--
Studio One Pro / i7-6700@3.80GHZ, 32GB Win 10 Pro x64
Roland FA06, LX61+, Fishman Tripleplay, FaderPort, US-16x08 + ARC2.5/Event PS8s 
Waves Gold/IKM Max/Nomad Factory IS3/K11U

#24
ricoskyl
Max Output Level: -84 dBFS
  • Total Posts : 327
  • Joined: 2015/03/15 13:19:05
  • Location: Clarkston, MI USofA
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/10/20 14:04:02 (permalink)
0
 
 
 
 
 
 
 
 
The help pane is really useful, but I'd like to be able to search help right from the Help menu.  
 
 
 
 
 
 
 
 
 
 
I

If you want to make enemies, try to change something. -Woodrow T. Wilson
Turbulence is a life force. It is opportunity. Let’s love turbulence and use it for change. -Ramsay Clark
----------------------
Sonar Platinum Win 10 x64 on HP Pavilion i7 5500 12Gb RAM, Tascam US-16x08, NVidia 840 8Gb vram, Multi-Screen, Multi-Touch
#25
vdd
Max Output Level: -89 dBFS
  • Total Posts : 92
  • Joined: 2014/12/22 17:26:14
  • Status: offline
Update of the Manual (PDF) please 2016/10/29 08:52:02 (permalink)
0
It would be great, if the manual in pdf-format gets an update. While the chtm-file is good at the pc, I like to have a pdf to print certain things, read on an tablet or even an ereader.
The version in my installation folder is from 2015 and there was happening a lot with the rolling updates...
Thank you!

S-Plat x64 / i7-4790-3.60GHZ, 32GB RAM, Win 7 x64, Akai MPC Studio, Arturia Microbrute, Doepfer A-100, VTB-1, RME HDSPe
#26
scook
Forum Host
  • Total Posts : 24146
  • Joined: 2005/07/27 13:43:57
  • Location: TX
  • Status: offline
Re: Update of the Manual (PDF) please 2016/10/29 10:00:37 (permalink)
0
merged
#27
pwalpwal
Max Output Level: -43 dBFS
  • Total Posts : 3249
  • Joined: 2015/01/17 03:52:50
  • Status: offline
Re: Update of the Manual (PDF) please 2016/10/29 10:34:16 (permalink)
0
wondering why the PDF version isn't kept up-to-date when the CHM version is? can't someone just do a "save as PDF" from the same source??
 

just a sec

#28
mudgel
Max Output Level: 0 dBFS
  • Total Posts : 12010
  • Joined: 2004/08/13 00:56:05
  • Location: Linton Victoria (Near Ballarat)
  • Status: offline
Re: Update the SONAR Reference Guide more frequently 2016/10/31 10:00:08 (permalink)
0
I'm all for keeping all the documents synchronised and up to date.

Mike V. (MUDGEL)

STUDIO: Win 10 Pro x64, SPlat & CbB x64,
PC: ASUS Z370-A, INTEL i7 8700k, 32GIG DDR4 2400, OC 4.7Ghz.
Storage: 7 TB SATA III, 750GiG SSD & Samsung 500 Gig 960 EVO NVMe M.2.
Monitors: Adam A7X, JBL 10” Sub.
Audio I/O & DSP Server: DIGIGRID IOS & IOX.
Screen: Raven MTi + 43" HD 4K TV Monitor.
Keyboard Controller: Native Instruments Komplete Kontrol S88.
#29
Jump to:
© 2022 APG vNext Commercial Version 5.1