The old developer documentation

I actually find it easier now with the tiles overview on the "Khoros Communities" node on dev docs:

For me I use the two rightmost tiles nowadays. Which makes sense since - like you - I've been developing for 8 years on the platform so I don't need the getting started content.

Prior to the 2021 overhaul I used what felt like two or three more clicks to find the v2 collection documentation or the odd v1 API doc. So for me it's an improvement.

Then clearly I'm missing something obvious.

How do I get from homepage to this page and section?

https://developer.khoros.com/khoroscommunitydevdocs/docs/messages

PerBonomi - Same feedback, it really hard to find from new documentation. 

Here is the navigation 

More > Dev Network > Community Dev Docs - 

API Reference > Community Api 2 Index > Message 

http://prntscr.com/xcvnpw
http://prntscr.com/xcvpf3

http://prntscr.com/xcvs3f

PerBonomi TariqHussain Thanks for this initial feedback. I'd love to speak with you two (and any other Devs out there) and walk through your experience and frustrations. I will reach out to you privately.

For any other devs, please feel free to reach out to me via private message to SuzieH or via documentation@khoros.com. I would love to set up a Zoom/Skype call to hear more.

Hi PerBonomi 

I think we made a mistake by nesting the individual LiQL reference pages under the collection index page. Also, I think we should also uplevel the FreeMarker object index on the new Community landing page on developer.khoros.com.

Here are a few quick useful links to bookmark:

• LiQL collection index (docs for fields, constraints, sorts, functions)
• Community API v2 object/endpoint index
• Community API v2 object/endpoint index
• FreeMarker object index

While you are here, Suzie: Any idea why the LiQL collection articles don't show up in the search? E.g. I wanted to suggest Per to use search, but the messages collection do shows up nowhere there. See following screenshot (and while you are looking at search can you disable the "Discussions" tab since that seems to be the ReadMe.com "Discussions" feature and always shows ip empty):

Hmmmm. I don't know what's happening there. I've been able to get to here via search in the past. And I'm able to get to some (randomly) in Search just now.

I will need to talk to our hosting platform. Thanks for the callout. Seems like a regression/bug on their end. I'm on it.

Claudius I played around some more and it does appear -- but it gets buried. Here are screenshots of what worked for me. 

Note that the LiQL reference uses the collection name -- which is plural (e.g. messages vs message). Also, filtering to the Guides section for when you need LiQL reference will narrow the results down

Also, I'm not sure why the search results don't for the LiQL reference docs don't include the subtitle that indicates what the guide includes. That seems to be a bug.

Including "liql" in the search term indeed magically bubbles the relevant collection documentation up. Would be great if they would get more weight even when just searching the collection names.

Also there seems to be a need to update the search index since searching for "content_workflow" doesn't yet show the collection doc at https://developer.khoros.com/khoroscommunitydevdocs/docs/content_workflow

(with and without "liql" in the search term 😉)