A definitive list of labels?

Mark Barnes said:

Several of these are not documented in the Logos 6 Help File.

EDIT: Keeping the below for posterity, but Eli has since corrected me that yes, we do document labels in the general help file. For interactives, the "About" page may document further searching capabilities as well. Apologies for the confusion.

----------------

Thanks, Mark. I'm sure Eli will respond to some of this, but one issue is that not all labels are available to all Logos 6 users.

Several of these are dependent on datasets that are licensed either by Logos 6 base packages or through Logos Now. For example, the label Psalm is only licensed through the dataset delivered with Logos Now; it also mirrors the book-level categories available in the Psalm Explorer interactive, in the "Overview". (Note the Proverbs label [6.7 beta], which isn't listed in the current incarnation of your post, is also reflective of the Proverbs Explorer interactive). The Figures of Speech label is also delivered with Logos Now (6.7 beta as well). So documenting them in the general Logos 6 help file isn't the best place; it would be confusing because the labels simply aren't available to everyone who would be reading that documentation.

For labels that are tied to interactives (Psalms, Proverbs, and some upcoming stuff) the interactive will be the place where they are mentioned, in the "About" dialog (note: I think Psalms needs to be updated to reflect this, and Proverbs will hopefully be updated during the 6.7 beta cycle). Generally, faceted interactives like Proverbs Explorer allow for faceting/display of interesting information associated with the text, and many times this information could provide further utility by exposing it to search. Labels are the way to do this, and as interactives develop and continue, we will, where it makes sense, pair a label with an interactive (like Psalms and Proverbs Explorers) to expose categorization data for searching.

You are correct that there is a larger issue, and it is one that I know Eli is actively considering (because he and I have talked about it).

Rick Brannan (Faithlife) said:

Thanks, Mark. I'm sure Eli will respond to some of this, but one issue is that not all labels are available to all Logos 6 users.

Our strategy thus far has been to document search capabilities of a dataset within the dataset documentation resource for the dataset. It's not a perfect solution, of course, especially since we are still way behind on the backlog of documentation. We are making progress, slowly but steadily.

In the meantime, I've asked the Help team to add a quick and dirty listing of labels that can be searched in the Help resource.

Mark, don't waste time reverse-engineering your milestone indexes and posting the results, except as curiosity. You will find many labels that are used only for making certain features work (for example Propositional Outlines, which has no user-readable content in the labels) or are not yet fully implemented in such a way that they can be searched -- for example, all of the Bible Background labels, such as "Origin" and "Content", which encode their values using the BGC datatype, which isn't searchable yet.

Mark Barnes said:

Actually, because I'm looking at my index, I can't see the things that aren't searchable yet, so apart from "Book Guide" (which I think is what you're referring to, and I stumbled across in the info panel), everything in my list is usable at the moment.

#facepalm ... nevermind, yes. Still, just because they're in the index doesn't mean they have (or are supposed to have) all the UI necessary to be searchable. We ferret away all kinds of data in the fulltext index to make various parts of the application work, sometimes with the intention of eventually making it visible to the search UI, and sometimes not.

For example, the fact that the Bible Book Guide labels appear in the information panel now as opposed to some point in the future is an unintended consequence of the recent overhaul of the Information tool. But now that they're exposed, we should take care to bring them up to functional parity.

Mark Barnes said:

But that at least explains why it's not searchable!

Quite. 

HansK said:

Suggestion: create a visible add and click search editor (something like Syntax searching) where all the options (strings) for a search can be found. And links to help on the various strings. So that all is in one place.

Why not both? That is, a Help article and some kind of helper. [:)]

Mark Barnes said:

My suggestion is that the { character triggers an autocomplete menu, just as the @ character does in a morph search

... and the < character would trigger data type names. 

Coincidentally, we are working on the spec for just such a contraption (though it may look a little different than your mockup since I don't know how much secret knowledge of each label type we'll be able to pump into the software, but we'll see).

Mark Smith said:

I think this is an excellent idea and exposes the search potential of Logos much more than a lengthy Help file article.

True, but a lengthy Help article I can get done today but improvements to the search term suggestion list I can only get you in six to twelve weeks at the earliest, maybe. [:)]

Alright, technically I didn't finish the documentation today, but I'm 80-90% there I reckon.

And no, don't give me a raise. I'm rather embarrassed that this slipped through the cracks, since I've been intending to do it for many moons now. Also, Luke 17:7-10.

Have a good weekend, y'all.

If you got an updated help resource along with 6.8, then check out these articles:

• Advanced Searching — rewritten and expanded.
• Searchable Labels — lists all the properties of each label class, with examples. Current up through the Bullinger's Figures of Speech dataset. Note this article may lag just a little, since we keep shipping datasets in the period between writing new documentation and publishing/updating the help file.  

All in a day's work. Or two.

The BookGuide label is delivered by the Bible Books Supplemental Dataset, but it is internal-only and not visible to (mere mortal) users, so we aren't planning to document it. You are correct that the other labels shipped by that same dataset (eg, "Background" and "Origin") have a Subcategory property rather than Comment. Oops! (I fixed that error; correct in the next update, whenever that is.)

Whatever you call it, that property isn't searchable right now because the BGC datatype reference it contains isn't searchable.

There's an open case for rearranging the labeling contained in this particular dataset to be better organized — the BGC dataset was one of the first label datasets we made, and our best practices have evolved since. There is also a case for making the BGC datatype searchable.

John Brumett said:

Why not add all these additional ways to search directly to the other templets in the search panel?

Hi, John. If you mean the Search "cookbook" recipes, those have been extended greatly in recent releases to cover pretty much all of the advanced and label search types:

I'm also on 6.8. There is a slim possibility that I am seeing something that hasn't been shipped yet. If so, call it a sneak peek. [;)]

Ron said:

Since we are now ~10 weeks out from the discussion about a search "helper" implementation (a la Mark Barnes' mockup), is there any chance we might start seeing the beginnings of that in 6.9 (or worst, 6.10)?

Sorry, I don't have anything to announce on that.