In Template codes (17370) I was given a link to how_to:narrative_report_fact_sentence_templates|> Narrative Report Fact Sentence Templates page in the KB.
I must admit while I knew of the KB, I did not think it was as good as it was. I've used the "Getting the Most From" booklet as a main reference, but I think I'll look at the KB in the future. I've printed off the index to keep as a desktop reference guide.
Could I however, make a request as a constructive comment though. I do appreciate the effort and the time that has gone into it, The Content seems great, but its readability is hard. I would like to suggest not immediate changes, but that when pages are re-written or updated, that some different thought is given to how they look to the user.
For me, there is just too much colour, bold and hyperlinks. It is very distracting when reading, making it difficult to take in the meaning as the eye is constantly drawn to the highlighted text.
If I did click on every hyperlink to read the link (I think there are 14 just in the view below alone) then firstly I'd never finish the original document, and secondly I'd probably have lost my place anyway, and never get back to the page I started at.
Towards the end of that page, it turns into almost total bold text - making it hard to read
Key differentiating words here such as Sentence and Template are semi-obscured by the black, and almost disappear from view.
The most important part of the KB should be the index, but its is in the smallest font, and contains too much duplication. Much of the Grey/Black text is an exact, or similar repetition of the Orange hyperlink, If there is only the one topic, then both descriptions might not be necessary in some cases.
It may even be that the "Knowledge Base Titles" page is of more use than the Index. Are both actually needed?
Apologies for going on a bit. As a Resource it is great, and fills a lot of blanks from the Official documentation, but it could be easier to read.
* The Knowledge Base
The Knowledge Base
Colin McDonald - Researching McDonald, McGillivray, Tait, Rountree families
- tatewise
- Megastar
- Posts: 28414
- Joined: 25 May 2010 11:00
- Family Historian: V7
- Location: Torbay, Devon, UK
- Contact:
Re: The Knowledge Base
Colin, I've moved this to the Web Site Usage forum that is more appropriate.
Thank you for the feedback, as we get very little usually.
Some of the points you raise we are aware of.
I presume you realise that the Knowledge Base is a wiki just like Wikipedia that has similar 'distracting' blue hyperlinks ~ you are not expected to follow them all ~ they provide cross-references for terms you may be unfamiliar with.
I have never been in favour of the orange coloured hyperlinks. As you say, when bold they are too strong, but without bold they are too pale. I would prefer the traditional blue hyperlinks.
Bold black has been used quite often to identify literal codes, but when they are long they do become overwhelming.
Elsewhere we have started to use a grey background style like that shown in contributeyourknowledge:edit_existing_pages#text_formats|> Text Formats for %INDI.BIRT.DATE%
Many users find it difficult to find advice about whatever topic they happen to be searching for.
The Search box top right only works if your keywords match the Knowledge Base keywords.
Similarly, the knowledge_base_titles|> Knowledge Base Titles don't help much unless your keywords are in the title. The Titles are not in any logical grouping but purely alphabetical, which users found unhelpful.
The alphabetic_index|> Knowledge Base Index is a new idea that is still evolving and meant to be more like a reference book index, where the same topic is listed under various related Subject headings and organised into related groupings. The style of the text is largely dictated by the wiki. I disagree that the black topic text and the orange hyperlink are usually the same.
We have recently been through a major exercise with the contributeyourknowledge:index|> Contribute Your Knowledge section to make it more approachable and logically structured. BTW: You can use that guide to change any of the Knowledge Base as you deem fit.
Most of the other sections are smaller and better structured.
BUT the how_to:index|> Family Historian section has a chequered history and grown like topsy as FH has gained more and more features, many of which are not covered in any depth in the FH Help pages or Getting the Most From Family Historian. It is long overdue for a major overhaul too! BUT that is an unenviable task.
Thank you for the feedback, as we get very little usually.
Some of the points you raise we are aware of.
I presume you realise that the Knowledge Base is a wiki just like Wikipedia that has similar 'distracting' blue hyperlinks ~ you are not expected to follow them all ~ they provide cross-references for terms you may be unfamiliar with.
I have never been in favour of the orange coloured hyperlinks. As you say, when bold they are too strong, but without bold they are too pale. I would prefer the traditional blue hyperlinks.
Bold black has been used quite often to identify literal codes, but when they are long they do become overwhelming.
Elsewhere we have started to use a grey background style like that shown in contributeyourknowledge:edit_existing_pages#text_formats|> Text Formats for %INDI.BIRT.DATE%
Many users find it difficult to find advice about whatever topic they happen to be searching for.
The Search box top right only works if your keywords match the Knowledge Base keywords.
Similarly, the knowledge_base_titles|> Knowledge Base Titles don't help much unless your keywords are in the title. The Titles are not in any logical grouping but purely alphabetical, which users found unhelpful.
The alphabetic_index|> Knowledge Base Index is a new idea that is still evolving and meant to be more like a reference book index, where the same topic is listed under various related Subject headings and organised into related groupings. The style of the text is largely dictated by the wiki. I disagree that the black topic text and the orange hyperlink are usually the same.
We have recently been through a major exercise with the contributeyourknowledge:index|> Contribute Your Knowledge section to make it more approachable and logically structured. BTW: You can use that guide to change any of the Knowledge Base as you deem fit.
Most of the other sections are smaller and better structured.
BUT the how_to:index|> Family Historian section has a chequered history and grown like topsy as FH has gained more and more features, many of which are not covered in any depth in the FH Help pages or Getting the Most From Family Historian. It is long overdue for a major overhaul too! BUT that is an unenviable task.
Mike Tate ~ researching the Tate and Scott family history ~ tatewise ancestry
Re: The Knowledge Base
I was not aware that the style was effectively forced on to you. That does make a difference
I will have a look in more detail at the Contribute your own knowledge section to see if I can learn more there.
However, the Index is still a little more complex than it needs be
Does anyone else have thoughts on this?
I will have a look in more detail at the Contribute your own knowledge section to see if I can learn more there.
However, the Index is still a little more complex than it needs be
Is one example where it is un-necessarily complex.Understanding Data References Understanding Data References
Understanding Expressions Understanding Expressions
Understanding Functions Understanding Functions
Does anyone else have thoughts on this?
Colin McDonald - Researching McDonald, McGillivray, Tait, Rountree families
- tatewise
- Megastar
- Posts: 28414
- Joined: 25 May 2010 11:00
- Family Historian: V7
- Location: Torbay, Devon, UK
- Contact:
Re: The Knowledge Base
A lot of the features in the wiki are derived from built-in options and predefine installed macros.
You have picked out three unfortunate examples in the Index that might be better.
However, the point is that they are grouped logically under Customisation and could just as easily appear as:
What are Expressions? Understanding Expressions | Understanding Data References | Understanding Functions
or any other subheading you would like to suggest, but still grouped with Customisation rather than say Fact Types.
Note that those same topics also appear under Data References and Expressions and Functions.
So whether a user starts from the keyword Customisation or Data References or Expressions or Functions they should reach those Understanding... topics.
Whereas in Knowledge Base Titles they are lumped in with every Title starting with U such as:
Uncategorised Data Fields
Understanding Data References
Understanding Expressions
Understanding Functions
Understanding Lua Patterns
Understanding Projects
: : : : : : : : : : : : : : : : : : : : : : : : :
Useful Research Software
Useful Research Web Sites
: : : : : : : : : : : : : : : : : : : : : : : : :
Using Named Lists
You have picked out three unfortunate examples in the Index that might be better.
However, the point is that they are grouped logically under Customisation and could just as easily appear as:
What are Expressions? Understanding Expressions | Understanding Data References | Understanding Functions
or any other subheading you would like to suggest, but still grouped with Customisation rather than say Fact Types.
Note that those same topics also appear under Data References and Expressions and Functions.
So whether a user starts from the keyword Customisation or Data References or Expressions or Functions they should reach those Understanding... topics.
Whereas in Knowledge Base Titles they are lumped in with every Title starting with U such as:
Uncategorised Data Fields
Understanding Data References
Understanding Expressions
Understanding Functions
Understanding Lua Patterns
Understanding Projects
: : : : : : : : : : : : : : : : : : : : : : : : :
Useful Research Software
Useful Research Web Sites
: : : : : : : : : : : : : : : : : : : : : : : : :
Using Named Lists
Mike Tate ~ researching the Tate and Scott family history ~ tatewise ancestry
- Jane
- Site Admin
- Posts: 8514
- Joined: 01 Nov 2002 15:00
- Family Historian: V7
- Location: Somerset, England
- Contact:
Re: The Knowledge Base
I have changed the knowledge base links to DarkBlue and turned off the bold.
The bold on the other items are entirely in the control of the editor of the page.
Jane
My Family History : My Photography "Knowledge is knowing that a tomato is a fruit. Wisdom is not putting it in a fruit salad."
My Family History : My Photography "Knowledge is knowing that a tomato is a fruit. Wisdom is not putting it in a fruit salad."
- Jane
- Site Admin
- Posts: 8514
- Joined: 01 Nov 2002 15:00
- Family Historian: V7
- Location: Somerset, England
- Contact:
Re: The Knowledge Base
For the example with the templates and the Sentences you could use unordered lists eg
Code: Select all
==== Census Event ====
This style caters for the **1939 National Register** and relies on the full address being in the **Place** field.
* Template:
* {individual} appeared in the {=TextIf(GetDisplayText(%FACT.DATE%,min) = "29 September 1939","National Register","Census")} {date} residing at {_place} {age}
* Sentence:
* He appeared in the Census on 31 March 1901 residing at 48, Springfield, Oxford, England aged 48.
* He appeared in the National Register on 29 September 1939 residing at 5, High Rd, Oxford, England.
Similarly for the **Census (family) Event**:
* Template:
* {couple} appeared in the {=TextIf(GetDisplayText(%FACT.DATE%,min) = "29 September 1939","National Register","Census")} {date} residing at {_place} {their ages}
* Sentence:
* They appeared in the Census on 31 March 1901 residing at 48, Springfield, Oxford, England when he was 34 and she was 31.
Jane
My Family History : My Photography "Knowledge is knowing that a tomato is a fruit. Wisdom is not putting it in a fruit salad."
My Family History : My Photography "Knowledge is knowing that a tomato is a fruit. Wisdom is not putting it in a fruit salad."