Search User Manual for Topics

Question

question

Sebastian Hemmann asked Jul 13 2020 at 6:37 AM Ben Wilson answered Dec 08 2020 at 5:20 PM

Search User Manual for Topics

Hi, played around with FlexSim 2020 Update 2 Beta and searched for "Color Palette" in the (online) user manual.

It looks as if the search is also done in Google and returning web pages. I´m wondering why it is not showing any link to the searched page of the user manual?

Bug or feature?

If feature, what would be the right way to search for this topic to find it in the user manual?

Software Version:

FlexSim 20.2.0

flexsim 20.2.0 search

results-sh.png (89.6 KiB)

manual-search-sh.png (69.1 KiB)

· 8

Ben Wilson ♦♦ commented · Jul 13 2020 at 6:37 PM

@sebastian.hemmann,

Can you try searching a different version of the manual to see if you still get wacky results?

Some of us get the seemingly random results that I show below, while others get stable and sensible results like @tanner.p described.

I've found that my search results make more sense on the 20.1 version of the manual and older. If this is the case for you, perhaps because the content of the 20.2 manual is still new Google is serving different results to different people as it builds out its search graph (totally guessing).

You might also try on a different computer or from a different ISP. I've found that changing browsers or using private sessions makes no difference for my search results, so it seems more a result of my internet connection than anything.

Whatever the cause, it is on Google's side because the query that goes through to them is the same regardless of who submitted. So hopefully they'll get their act together on a proper index of the 20.2 version of the manual soon :)

0 ·

Sebastian Hemmann Ben Wilson ♦♦ commented · Jul 14 2020 at 6:22 AM

Hi @ben.wilson , tried out what you´ve described but this morning I get the following result:

Always the same result altough I use different browsers and look in different versions.

Also tried out other words. But it seems to work for me now. So what ever you´ve changed works for me.

Strangely the number of Google Ad results is changing and sometimes is even 0.

0 ·

search-result1-sh.png (95.8 KiB)

search-result2-sh.png (95.3 KiB)

search-result3-sh.png (106.3 KiB)

Ben Wilson ♦♦ Sebastian Hemmann commented · Jul 14 2020 at 1:46 PM

Hi @sebastian.hemmann,

Looks like your attachments were lost. The images may show in your browser (cached) but for me they look like this:

Could you edit your comment and reattach your images?

BTW, I didn't change anything about the search. We still just send the same query to Google and let them do their thing, so if behavior is different now, that is just Google.

0 ·

1594734288256.png (9.4 KiB)

Show more comments

Sebastian Hemmann commented · Nov 13 2020 at 10:19 AM

@Ben Wilson and @tanner.p, sorry but I have to bring this up again. In the last training session I tried to show how good our user manual works and we searched for "3d shape" because this returns the site: "Creating and Importing Custom 3D Objects" as best result in the offline user manual.

In the online user manual I don´t get close results, no mater what version I search in!?

And even if i search for "Creating and Importing Custom 3D Objects" the result is not found.

0 ·

offline.png (67.7 KiB)

online.png (109.5 KiB)

Ben Wilson ♦♦ Sebastian Hemmann commented · Nov 13 2020 at 5:00 PM

@sebastian.hemmann,

Not sure why they don't give more relevant results. It's somewhat surprising the in-docs search results are so bad, and certainly disappointing.

Google's search results of FlexSim docs starting from their own search page are really quite good:

https://www.google.com/search?q=3d+shape+site%3Adocs.flexsim.com

I'm not sure why the integrated search is so different.

In the end we may just need to do our own search indexing, instead of relying on Google. Some possibilities:

0 ·

Ben Wilson ♦♦ Ben Wilson ♦♦ commented · Nov 13 2020 at 5:55 PM

@Markus Cueva,

This search shows expected results (search text: 3d shape site:docs.flexsim.com/en/19.0/):

https://www.google.com/search?q=3d+shape+site%3Adocs.flexsim.com%2Fen%2F19.0%2F&oq=3d+shape+site%3Adocs.flexsim.com%2Fen%2F19.0%2F

While this search is not as good (3d shape site:docs.flexsim.com/en/20.2/):

https://www.google.com/search?q=3d+shape+site%3Adocs.flexsim.com%2Fen%2F20.2%2F&oq=3d+shape+site%3Adocs.flexsim.com%2Fen%2F20.2%2F

This must be why a search of 3d shape site:docs.flexsim.com works great - it's pulling content from all versions. But then, when you narrow down to a single user manual version, results get wacky.

Is this because the content of user manuals, across versions, is 90% the same, and so Google's indexing is not taking into account identical pages from newer manuals? Thus when you search a newer manual, you don't get good results?

As our resident Google expert, do you know what, if anything, can be done to improve our Google Site Search performance to account for this apparent issue?

0 ·

Show more comments

______

Cookie preferences

Your privacy is important to us and so is an optimal experience. To help us customize information and build applications, we collect data about your use of this site.

May we collect and use your data?

Learn more about the Third Party Services we use and our Privacy Statement.

Strictly necessary – required for our site to work and to provide services to you

These cookies allow us to record your preferences or login information, respond to your requests or fulfill items in your shopping cart.

YES

Improve your experience – allows us to show you what is relevant to you

These cookies enable us to provide enhanced functionality and personalization. They may be set by us or by third party providers whose services we use to deliver information and experiences tailored to you. If you do not allow these cookies, some or all of these services may not be available for you.

YES

NO

Customize your advertising – permits us to offer targeted advertising to you

These cookies collect data about you based on your activities and interests in order to show you relevant ads and to track effectiveness. By collecting this data, the ads you see will be more tailored to your interests. If you do not allow these cookies, you will experience less targeted advertising.

YES

NO

Are you sure you want a less customized experience?

We can access your data only if you select "yes" for the categories on the previous screen. This lets us tailor our marketing so that it's more relevant for you. You can change your settings at any time by visiting our privacy statement

Your experience. Your choice.

We care about your privacy. The data we collect helps us understand how you use our products, what information you might be interested in, and what we can improve to make your engagement with Autodesk more rewarding.

May we collect and use your data to tailor your experience?

Explore the benefits of a customized experience by managing your privacy settings for this site or visit our Privacy Statement to learn more about your options.

Answer 1 · 2020-12-08T17:20:47Z

Ben Wilson answered Dec 08 2020 at 5:20 PM

@sebastian.hemmann,

We've implemented our own search on docs.flexsim.com:

Now each version of the user manual is individually indexed.

Hopefully this will give better results and a better user experience.

1607447990969.png (32.7 KiB)

Answer 2 · 2020-07-13T16:53:52Z

tannerp answered Jul 13 2020 at 4:53 PM Sebastian Hemmann commented Jul 14 2020 at 6:29 AM

@sebastian.hemmann,

What was the exact wording/phrasing of what you googled? When I searched the user manual for "Color Palette", the page you indicated was my first result.

search-user-manual.png (64.9 KiB)

· 3

Ben Wilson ♦♦ commented · Jul 13 2020 at 5:09 PM

Here is a .gif showing seemingly random and different results each time you press the search submit button:

FlexScript Class - Token, People Settings, FlexScript Class - Token (again), then finally Color Palette. I'm not really sure what to make of this.

We may need to implement our own search using Apache Solr or Elasticsearch or something. @jacob.gillespie

We're actually looking into integrating docs.flexsim.com search results into the automatic suggestions that Answers presents when you are composing a new question. AnswerHub uses Elasticsearch on their backend. Perhaps we'll be able to leverage that here on docs.flexsim.com as well. It's still in the exploratory stages. We'll see what happens.

1 ·

randomsearchresults.gif (449.3 KiB)

Ben Wilson ♦♦ commented · Jul 13 2020 at 5:13 PM

Another interesting fact, searching "color palette site:docs.flexsim.com" directly at google.com DOES show the expected Color Palette page as the first result, and shows the same results each time I submit the query.

Not sure why the site search integrated into docs.flexsim.com would differ from a search directly from google.com. Something more to look into. @jacob.gillespie

1 ·

Sebastian Hemmann commented · Jul 14 2020 at 6:29 AM

Hi @tanner.p , "color palette" was the exact phrasing I´ve searched in the user manual.

0 ·

question