* The New Knowledgebase

Please only post suggestions and requests for help on using this web site here.

For help with FAMILY HISTORIAN itself please post in the Using Family Historian - General Usage Forum above.
Post Reply
User avatar
ColeValleyGirl
Megastar
Posts: 1686
Joined: 28 Dec 2005 22:02
Family Historian: V6.2
Location: Cirencester, Gloucestershire
Contact:

The New Knowledgebase

Post by ColeValleyGirl » 31 May 2020 13:21

The new Knowledge Base platform is now ready for migration to start (apart, of course, for the bugs that you eagle-eyed lot will find). Many thanks to Valkrider (Colin) for doing much of the technical heavy lifting (he's much more familiar with WordPress than I am, and doesn't complain at all when I say 'but it would be better if we could just...')

We've focused on making it easy to find content, and to do this, consulted best practice guidelines for a load of Knowledge Bases across the Internet.

The interface is deliberately uncluttered and uncomplicated -- you find the content you want by one of two methods:
  1. Structured browsing by content type and category/sub-category.
  2. A single Search box that works consistently everywhere, and will search the content as written (filtered by content type if you wish) plus category terms and any additional search terms assigned by the article's author to make a piece of content more 'discoverable'. (My perennial example: there will be an article about restoring data from a backup, but it will also have the search term 'recover' because not everybody reaches for the same word for the same thing).
Editing is more straightforward than the old KB as well. For those people who don't want to do more than submit their website, or a download, or recommend a service or utility, they can fill in a simple form (without registering for an account, but quoting their FHUG account details) and after spam-checking and review by an administrator, the content will be published. For people who want to do more complex editing, once they've applied for an editor's account, it's basically standard WordPress editing with some FH specific customisations to make life easier and some simplifications to enforce consistency.

Take a look: New Knowledge Base.

Note: some of the content is test content or has been migrated by a script and needs 'reviewing/sorting out' during the migration process; other content is in the process of being migrated article by article.

There's a style guide in place that addresses formatting and layout (based on best practice for readability), to keep everything looking consistent, but we haven't made any assumptions about the types of articles we will eventually end up with (as we started discussing at Towards a style guide for the new Knowledgebase (17458).)

Our preference is that we focus on migrating existing content first (improving the quality and discoverability if necessary as we go) in parallel with a continued discussion about the types of new content we want to add. Ideally, we'll get all existing content over before FH7 hits, so we only have to make changes in one KB for FH7. Once existing content is across (or discarded), work can start on adding new content (How-To Guides etc.)

We have resources set up for migration: there's an article on how to do it and anyone who applies for an editor's account during the migration period will be given access to the relevant Trello boards (used for tracking migration activity) and a closed mailing list to discuss migration issues (so as not to clutter up the FHUG forums with stuff that's meaningless to most people).

A couple of migration notes: We're going to leave Plugin Help pages where they are in the old KB because of their specific formatting requirements -- they will continue to work as long as needed; and Ancestral Sources documentation will be handled as a separate migration project once the main migration is complete.

So... please volunteer to help the migration and sign up for an editor's account -- the more volunteers we get the faster it will go. Even if you only do one article or a few of the simpler content types, it will really help!

avatar
redvanman
Gold
Posts: 28
Joined: 10 Jun 2010 10:51
Family Historian: V6.2
Location: Dalbeattie, Kirkcudbrightshire

Re: The New Knowledgebase

Post by redvanman » 01 Jun 2020 08:37

A fantastic acheivement, and a huge improvement.
Well done all

Alyn

User avatar
ColeValleyGirl
Megastar
Posts: 1686
Joined: 28 Dec 2005 22:02
Family Historian: V6.2
Location: Cirencester, Gloucestershire
Contact:

Re: The New Knowledgebase

Post by ColeValleyGirl » 01 Jun 2020 08:51

It will be even better when all the content is migrated but thank you on behalf of Jane, Colin and I.

User avatar
ColeValleyGirl
Megastar
Posts: 1686
Joined: 28 Dec 2005 22:02
Family Historian: V6.2
Location: Cirencester, Gloucestershire
Contact:

Re: The New Knowledgebase

Post by ColeValleyGirl » 01 Jun 2020 16:55

Thanks to those of you who have volunteered to help with the migration so far -- more volunteers are always welcome!

We'd be grateful if changes to the current KB could be kept to a minimum -- we're not freezing it because some changes are obviously necessary, and content that isn't currently planned to be migrated will need to be updated by the authors.

We're still looking at how we can make it possible to migrate plugin help so watch this space.

User avatar
jimlad68
Megastar
Posts: 645
Joined: 18 May 2014 21:01
Family Historian: V6.2
Location: Sheffield, Yorkshire, UK (but from Lancashire)
Contact:

Re: The New Knowledgebase

Post by jimlad68 » 01 Jun 2020 20:25

Apologies if I missed something, and please excuse my curiosity, but why do we need a new New Knowledgebase, some technical reason perhaps, outdated software, or a new super platform?
Jim Orrell - researching: see - but probably out of date https://gw.geneanet.org/jimlad68

User avatar
LornaCraig
Megastar
Posts: 1738
Joined: 11 Jan 2005 17:36
Family Historian: V6.2
Location: Oxfordshire, UK

Re: The New Knowledgebase

Post by LornaCraig » 01 Jun 2020 20:55

jimlad68 wrote:
01 Jun 2020 20:25
Apologies if I missed something......
You must have missed some very protracted discussions back in February, Jim:
Improving Accessibility of Commonly Requested Help (17443)
and
What is the purpose of the FHUG Knowledgebase? (17450)
and
Towards a style guide for the new Knowledgebase (17458)

Many thanks to Helen and Colin for their work on this. I don't think I'd be much use as a volunteer because it would be a very steep learning curve but I do appreciate what's being done.
Lorna

User avatar
jimlad68
Megastar
Posts: 645
Joined: 18 May 2014 21:01
Family Historian: V6.2
Location: Sheffield, Yorkshire, UK (but from Lancashire)
Contact:

Re: The New Knowledgebase

Post by jimlad68 » 01 Jun 2020 22:23

thanks lorna, I will check them out
Jim Orrell - researching: see - but probably out of date https://gw.geneanet.org/jimlad68

avatar
E Wilcock
Megastar
Posts: 968
Joined: 11 Oct 2014 07:59
Family Historian: V6.1
Location: London
Contact:

Re: The New Knowledgebase

Post by E Wilcock » 08 Jun 2020 11:09

I can see from the contents page (still incomplete) that this is going to be far easier to navigate for forgetful old people like me.
I was trying to find out yesterday whether one could put death of a parent into the All tab of the property box. I gather that one cant (it is only the death of a spouse)
But as the answer was a negative, that took a long time to not find something.

User avatar
ColeValleyGirl
Megastar
Posts: 1686
Joined: 28 Dec 2005 22:02
Family Historian: V6.2
Location: Cirencester, Gloucestershire
Contact:

Re: The New Knowledgebase

Post by ColeValleyGirl » 08 Jun 2020 12:23

I'm glad it looks promising. I'm hoping to make some changes to the search feature on the new KB which will make it even more usable when it's complete.

User avatar
tatewise
Megastar
Posts: 18489
Joined: 25 May 2010 11:00
Family Historian: V6.2
Location: Torbay, Devon, UK
Contact:

Re: The New Knowledgebase

Post by tatewise » 08 Jun 2020 13:54

It is easy to show on the All tab the Death or any other fact of any close relative: Spouse, Father, Mother, Sibling.
Just a matter of expanding the Spouse family or Parents family links and then expanding the Individual records.
Mike Tate ~ researching the Tate and Scott family history ~ tatewise ancestry

Post Reply