3 ms·
One way to look at the problem is to try to determine _why_ is that you can't find the documentation. I assume you used your wiki's search function - then why c
by theamk 2y ago
One way to look at the problem is to try to determine _why_ is that you can't find the documentation. I assume you used your wiki's search function - then why couldn't you find it?
Are you not familiar with keywords, so your search results return nothing? In this case, a glossary or a list of (company-specific) synonyms might help.
A common cause of empty search results is if the pages are so short that you need exact keywords to bring them up. In this case, adding explicit "Keywords:" section, including any error messages in full and adding a paragraph of motivation can help the documents to be found.
Are there too many matches, so you get overwhelmed and miss the correct page? In this case you'd want to work on titles, or go the other way and clean up the pages. Some basic category organization will be helpful too.
Sometimes the search is just bad. No excludes, or words don't match half of the time, or random matches, or knowledge is spread across half-a-dozen websites... This is hard to fix, but bringing up a separate search system (or AI agent nowadays) might still be easier than rewriting every single page to accommodate broken search.
In the worst case, you'll may try to give up on "search" completely and try a strict hierarchical organization, like Yahoo web directories in 1995. This may work great for introductory topics, but I don't think this will work for every single doc. There is a reason no one uses web directories anymore.
- sky2224 2y ago> Sometimes the search is just bad... Honestly, I think this is the biggest issue with my company's current system. Confluence search just doesn't seem to... well, search (I'm also not the only person to have this issue where I work). What I mean is that I'll search for a page that I know exists, but Confluence just won't include it, so it seems like Atlassian's search functionality is behaving poorly. This actually might be something I should bring up with my department to see if there's possibly a fix. I like the suggestion of adding a keywords section, that actually might help a lot as well. Inclusion of an AI agent would probably be beneficial as well, although may be a little bit harder to get implemented since my company is being very cautious about what data we feed into models for privacy, legal, etc reasons.