Previous Thread
Index
Next Thread
Print Thread
Go To
#687939 12/04/21 06:36 AM
Band-in-a-Box Wishlist
Joined: Jan 2015
Posts: 2,666
Veteran
OP Offline
Veteran
Joined: Jan 2015
Posts: 2,666
I thought I'd start a thread here with what I hope are constructive thoughts on the manuals, and ideas on how to make them easier to read and understand.

I'd earlier said in a thread started by malevans that I thought the manual was "cluttered", so I thought I should expand on that. Someone also mentioned the Reaper manual as quite a good example, though there are several others. Reaper, BTW, have a footnote on each page with a link to LULU.com who are one of several organisations that offer printed manuals on demand.


Some of that "clutter" is due to probable documentation conventions, which could be made more concise by declaring those conventions somewhere, possibly right near the start of the manual. For example the convention used for buttons: [Style] if explicitly defined in the conventions as a button, would negate the need within the body text to say "using the [Style] button". Icons are good, though can be confusing when there are multiple GUI styles available, e.g., the monochrome or coloured icons styles.

Similarly predefine font meanings. Generally, the fewer fonts the better, though in manuals for software, "fewer" is usually quite hard to achieve.

Similarly sequences of actions. I personally tend to use, e.g., File->Load_Style_Special->"filename"->[OK] to describe a sequence. I note that the | symbol is used in some places, which is OK (though for me | means "or"). This would reduce the desire/need to use verbal descriptions.

A common problem in the manuals for many applications is that a section describing something, e.g., perhaps the MIDI Settings, without telling the user, right at that point, how to get to that something. Incidentally, I picked that from the index, expecting to see the instructions for setting up a MIDI device.

During a main explanation, focus upon a "preferred" way to do something, offering "other ways to do this" as a separate item. Then each of the sequences can be described completely in and of itself.

Hierarchically numbering every header helps navigation, and also helps suggestions or error-reports to focus closely to the correct location. In my specifications, where I need to incorporate similar changes, I usually number every paragraph, though most word-processors seem appallingly bad at doing that properly. A fall-back I've used is to number every line on every page, which is something with which most word-processors seem more adept. "Changed" indicators are often useful if the tools support them. You almost certainly already do that internally; it can be less useful in a published document, as it add clutter.

White-space, including indenting, helps quick navigation by eye and usually makes the document look nicer. On a .pdf document, white-space costs nothing. Printed it can, but better clarity can often reduce the number of pages needed.
It's worth looking at the keyboard shortcuts section and considering how an additional line before each sub-header and indenting the keys from that header would make it easier to use. At present, it isn't easy to pick out the subheadings from the keys. It's worth noting that many publishers consider the white-space to be the most important part of a document, yet we ordinary folk tend to forget it, particularly when close to a particular text. It can pay sometimes, just to hold a page at arms-length and look at it.

It's surprising how much the choice of font affects the appearance of a document. Some publishers are quite obsessive about fonts. I can see why. I take some care with them, but I'm neither obsessive, nor really a publisher.

Good indices are a Godsend, but are also darned hard work to do well. The best indices are defined manually by the authors, based upon good keywords by which people will want to look for things, but that's a huge task which most of us baulk at. Sometimes what's important is to exclude things that are not so helpful. BiaB's index is not actually bad, though it could be better.

I think a separate sub-section just for the chord-entry shortcuts might be worthwhile.

In quite a few documents, I despair at the standard of grammar and punctuation. I have to say that I haven't noticed any real howlers, no "xxx was charged with murder in the court today".

The following may well not be feasible with BiaB now, and is much more software design than manual. Some software has a philosophy: "Everything that you can do with any object will be found in a right-click menu on that object".

I think I've written more than enough for now.


Jazz relative beginner, starting at a much older age than was helpful.
AVL:MXE Linux; Windows 11
BIAB2026 Audiophile, a bunch of other software.
Kawai MP6, Ui24R, Focusrite Saffire Pro40 and Scarletts
.
Band-in-a-Box Wishlist
Joined: Dec 2018
Posts: 110
R
Apprentice
Offline
Apprentice
R
Joined: Dec 2018
Posts: 110
Very Well said GS. I concur.
I have, in the past, taken content out of the pdf into Word to reformat for precisely the reasons you outline here.

the manual is large and it is superb to have it in two file formats. I Often search the file for info I am after.

How do you feel about a collaborative community project to reformat the Manual?
Assuming we obtain PGM consultative support for the project. And use of IP approval.
Use something like GitHub for version control

RrR

Band-in-a-Box Wishlist
Joined: Jan 2015
Posts: 2,666
Veteran
OP Offline
Veteran
Joined: Jan 2015
Posts: 2,666
Originally Posted By: RoyReddy
How do you feel about a collaborative community project to reformat the Manual?
Assuming we obtain PGM consultative support for the project. And use of IP approval.
Use something like GitHub for version control

RrR

It's certainly something I would be prepared to keep in mind. I think there's a good change PGM may be amenable to the idea as, it seems to me, they must know the manual has been less than perfect for some time, but I suspect they also well understand that it'll likely be a huge task.

If they were amenable, then some dialogue to firm up ideas like mine above, though not necessarily actually mine above ... I'm sure others have comparable thoughts ... then we could establish a convention and potentially have many people working towards the same goal.

I just thought to look if there are other language versions. There appears not to be. That's a relief for now, but offers perhaps both a challenge and an opportunity for the future.


Jazz relative beginner, starting at a much older age than was helpful.
AVL:MXE Linux; Windows 11
BIAB2026 Audiophile, a bunch of other software.
Kawai MP6, Ui24R, Focusrite Saffire Pro40 and Scarletts
.
Band-in-a-Box Wishlist
Joined: Jun 2012
Posts: 3,928
J
Veteran
Offline
Veteran
J
Joined: Jun 2012
Posts: 3,928
Originally Posted By: RoyReddy
How do you feel about a collaborative community project to reformat the Manual?
Assuming we obtain PGM consultative support for the project. And use of IP approval.
Use something like GitHub for version control

It could possibly work if you had enough people who were passionate and capable enough. They would have to put in a ton of work. And even if they succeeded would need to reconvene every year to cover new and changed features. In my life in tech I have seen many attempts at a project like this but not many successes. And even the successes were never sustained for long. My opinion is this effort has to come from those who have a vested interest, namely, PGM.

Band-in-a-Box Wishlist
Joined: Jan 2015
Posts: 2,666
Veteran
OP Offline
Veteran
Joined: Jan 2015
Posts: 2,666
Originally Posted By: JohnJohnJohn
My opinion is this effort has to come from those who have a vested interest, namely, PGM.

Indeed.

My reason for posting was to share some ideas that may help and perhaps to encourage PGM, rather than to suggest a user-authored manual.

Also, if I'm honest, the brutal and vindictive way I was treated by my last employer has left me struggling with some mental issues, particularly around focus on a task. I used to be bullet proof unstoppable. Now I struggle at least some of the time most days.


Jazz relative beginner, starting at a much older age than was helpful.
AVL:MXE Linux; Windows 11
BIAB2026 Audiophile, a bunch of other software.
Kawai MP6, Ui24R, Focusrite Saffire Pro40 and Scarletts
.
Band-in-a-Box Wishlist
Joined: Dec 2018
Posts: 110
R
Apprentice
Offline
Apprentice
R
Joined: Dec 2018
Posts: 110
OK that makes sense. NP

Previous Thread
Next Thread
Go To

Link Copied to Clipboard
ChatPG

Ask sales and support questions about Band-in-a-Box using natural language.

ChatPG's knowledge base includes the full Band-in-a-Box User Manual and sales information from the website.

PG Music News
2026 Free Bonus PAK & 49-PAK for Band-in-a-Box® 2026 for Mac®!

With your version 2026 for Mac Pro, MegaPAK, UltraPAK, UltraPAK+, Audiophile Edition or PlusPAK purchase, we'll include a Bonus PAK full of great new Add-ons for FREE! Or upgrade to the 2026 49-PAK for only $49 to receive even more NEW Add-ons including 20 additional RealTracks!

These PAKs are loaded with additional add-ons to supercharge your Band-in-a-Box®!

This Free Bonus PAK includes:

  • The 2026 RealCombos Booster PAK: -For Pro customers, this includes 27 new RealTracks and 23 new RealStyles. -For MegaPAK customers, this includes 25 new RealTracks and 23 new RealStyles. -For UltraPAK customers, this includes 12 new RealStyles.
  • MIDI Styles Set 92: Look Ma! More MIDI 15: Latin Jazz
  • MIDI SuperTracks Set 46: Piano & Organ
  • Instrumental Studies Set 24: Groovin' Blues Soloing
  • Artist Performance Set 19: Songs with Vocals 9
  • Playable RealTracks Set 5
  • RealDrums Stems Set 9: Cool Brushes
  • SynthMaster Sounds Set 1 (with audio demos)
  • iOS Android Band-in-a-Box® App
Looking for more great add-ons, then upgrade to the 2026 49-PAK for just $49 and you'll get:
  • 20 Bonus Unreleased RealTracks and RealDrums with 20 RealStyle.
  • FLAC Files (lossless audio files) for the 20 Bonus Unreleased RealTracks and RealDrums
  • MIDI Styles Set 93: Look Ma! More MIDI 16: SynthMaster
  • MIDI SuperTracks Set 47: More SynthMaster
  • Instrumental Studies 25 - Soul Jazz Guitar Soloing
  • Artist Performance Set 20: Songs with Vocals 10
  • RealDrums Stems Set 10: Groovin' Sticks
  • SynthMaster Sounds & Styles Set 2 (sounds & styles with audio demos)

Learn more about the Bonus PAK and 49-PAK for Band-in-a-Box® 2026 for Mac®!

XPro & Xtra Styles PAK Sets On Sale Now - Until May 15, 2026!

All of our XPro Styles PAKs and Xtra Styles PAKs are on sale until May 15th, 2026!

It's the perfect time to expand your Band-in-a-Box® style library with XPro and Xtra Styles PAKs. These additional styles for Band-in-a-Box® offer a wide range of genres designed to fit seamlessly into your projects. Each style is professionally arranged and mixed, helping enhance your songs while saving you time.

What are XPro Styles and Xtra Styles PAKs?

XPro Styles PAKs are styles that work with any version (Pro, MegaPAK, UltraPAK, UltraPAK+, or Audiophile Edition) of Band-in-a-Box® 2025 (or higher). XPro Styles PAKS 1-10 includes 1,000 styles!

Xtra Styles PAKs are styles that work with the UltraPAK, UltraPAK+, or Audiophile Edition of Band-in-a-Box® 2025 (or higher). Xtra Styles PAKs 1-21 includes 3,700 styles (and 35 MIDI styles)!

The XPro & Xtra Styles PAKs are not included in any Band-in-a-Box® package.

The XPro Styles PAKs 1-10 are available for only $29 ea (reg. $49 ea), or get them all in the XPro Styles PAK Bundle for only $149 (reg. $299)! Listen to demos and order now! For Mac or for Windows.

The Xtra Styles PAKs 1-21 are available for only $29 ea (reg. $49 ea), or get them all in the Xtra Styles PAK Bundle for only $199 (reg. $349)! Listen to demos and order now! For Mac or for Windows.

Note: XPro Styles PAKs require Band-in-a-Box® 2025 or higher and are compatible with ANY package, including the Pro, MegaPAK, UltraPAK, UltraPAK+, and Audiophile Edition.

The Xtra Styles require the UltraPAK, UltraPAK+, or Audiophile Edition of Band-in-a-Box®. (Xtra Styles PAK 19 requires the 2025 or higher UltraPAK, UltraPAK+, or Audiophile Edition. They will not work with the Pro or MegaPAK version as they require the RealTracks included in the UltraPAK, UltraPAK+, or Audiophile Edition.

Supercharge your Band-in-a-Box today with XPro Styles PAKs and Xtra Styles PAK Sets!

Band-in-a-Box 2026 for Mac Videos

With the release of Band-in-a-Box® 2026 for Mac, we’re rolling out a collection of brand-new videos on our YouTube channel. We’ll keep this forum post updated so you can easily find all the latest videos in one convenient spot.

Whether you're exploring new features, checking out the latest RealTracks or Style PAKs, this is your go-to guide for Band-in-a-Box® 2026.

Check out this forum post for "One Stop Shopping" of our Band-in-a-Box® 2026 Mac Videos!

Band-in-a-Box 2026 for Mac is Here!

Band-in-a-Box® 2026 for Mac is here and it is packed with major new features! There’s a new modern look, a GUI redesign to all areas of the program including toolbars, windows, workflow and more. There’s a Multi-view layout for organizing multiple windows. A standout addition is the powerful AI-Notes feature, which uses AI neural-net technology to transcribe polyphonic audio into MIDI—entire mixes or individual instruments—making it easy to study, view, and play parts from any song. And that’s just the beginning—there are over 100 new features in this exciting release.

Along with version 2026, we've released an incredible lineup of new content! There's 202 new RealTracks, brand-new RealStyles, MIDI SuperTracks, Instrumental Studies, “Songs with Vocals” Artist Performance Sets, Playable RealTracks Set 5, two new RealDrums Stems sets, XPro Styles PAK 10, Xtra Styles PAK 21, and much more!

Special Offers
Upgrade to Band-in-a-Box® 2026 for Mac and save up to 50% on most upgrade packages during our special offer—available until May 15, 2026. Visit our Band-in-a-Box® packages page to explore all available upgrade options.

2026 Free Bonus PAK & 49-PAK Add-ons
Our Free Bonus PAK and 49-PAK are loaded with amazing add-ons! The Free Bonus PAK is included with most Band-in-a-Box® 2026 for Mac packages, but you can unlock even more—including 20 unreleased RealTracks—by upgrading to the 2026 49-PAK for just $49.

Holiday Weekend Hours

As we hop into the Easter weekend, here are our holiday hours:

April 3 (Good Friday): 8:00 AM – 4:00 PM PDT
April 4 (Saturday): Closed
April 5 (Easter Sunday): Closed
April 6 (Easter Monday): Open regular hours

Wishing you an egg-cellent weekend!

— Team PG

Update to Build 10 of RealBand® 2026 for Windows®!

If you're already using RealBand 2026 for Windows, download build 10 to get all the latest additions and enhancements.

Band-in-a-Box® 2025 for Mac® users: Build 904 now available!

If you're already using Band-in-a-Box® 2025 for Mac®, make sure to grab the latest update! Build 904 is now available for download and includes the newest additions and enhancements from our team.

Forum Statistics
Forums57
Topics86,268
Posts802,525
Members40,079
Most Online64,515
Apr 8th, 2026
Newest Members
Balkanmytime, Cutta414, Hermann Jo, Schusterpech, Kingloud
40,078 Registered Users
Top Posters(30 Days)
MarioD 124
zedd 111
rsdean 89
DC Ron 82
vicarn 61
Today's Birthdays
There are no members with birthdays on this day.
Powered by UBB.threads™ PHP Forum Software 7.7.5