# Xojo Documentation is useless **URL:** \ **Category:** Getting Started\ **Created:** [August 3, 2022, 6:25pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524 "2022-08-03T18:25:17Z")\ **Posts on this page:** 20\ **Page:** 5
**Author:** ![Emile\_Schwarz](https://forum.xojo.com/letter_avatar_proxy/v4/letter/e/90ced4/32.png) [@Emile\_Schwarz](https://forum.xojo.com/u/Emile_Schwarz)\ **Post date:** [August 11, 2022, 11:48am UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/84 "2022-08-11T11:48:16Z")
> [@Torsten\_Bernhard](#): > > What is the advantage we get with Xojo’s doc search over a search as implemented in Python docs? It is my Doc Search ! ---
**Author:** ![Ian\_Kennedy](https://forum.xojo.com/user_avatar/forum.xojo.com/ian_kennedy/32/6860_2.png) [@Ian\_Kennedy](https://forum.xojo.com/u/Ian_Kennedy)\ **Post date:** [August 11, 2022, 12:28pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/85 "2022-08-11T12:28:45Z")
The Control Set page needs to be put back into the new documentation. It is a feature of the language and needs to remain. The ability to load controls at runtime in no way replicates the use of control sets that I use all the time. For example: I have a menu, on that menu are 26 MenuItems. they represent the different types of statistical analysis my application can perform. Each one of them basically has the same workflow. They present a dialog box requesting parameters, they wait for permission to proceed and then produce the output and display it. I have one Menu Handler for all 26 items. Without control sets I would need 26 different MenuItems each of them doing the very same thing. To create this I simply name my menu items with the same name and ensure the Index property is set correctly for each. To do this at runtime I would have to build the menu using code, label it in code and then have a class that dealt with the operational side. No were near as trivial. [https://tracker.xojo.com/xojoinc/xojo/-/issues/69708](https://tracker.xojo.com/xojoinc/xojo/-/issues/69708) ---
**Author:** ![KarenA](https://forum.xojo.com/letter_avatar_proxy/v4/letter/k/c89c15/32.png) [@KarenA](https://forum.xojo.com/u/KarenA)\ **Post date:** [August 11, 2022, 2:50pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/86 "2022-08-11T14:50:08Z")
> [@Ian\_Kennedy](#): > > The Control Set page needs to be put back into the new documentation. It is a feature of the language and needs to remain. I remember, I and others, posting that the two features are not the same and that controls sets serve a different purpose when this came up before and they are both needed and control sets should not be deprecated (or hidden!)… But Xojo Inc seems to think otherwise, despite what to me seems to be arguments that should be persuasive… They have been doing a lot of that. -Karen ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:02pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/87 "2022-08-11T15:02:09Z")
> [@Geoff\_Perlman](#): > > In the old docs (and you can try this yourself), the first page of search results (20 items in total) doesn’t include a single page that has anything to do with graphics. He wasn’t search for “graphics”. He was searching for “grap”. When you search for “grap” in the old docs you get nothing related to graphics. In the new docs you at least get items related to graphics and now, after I added a “graphics” hint, you get the graphics page itself. This is an issue with this particular term because it’s a common actual word all over the documentation compared to something like DesktopListBox for example. ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:08pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/88 "2022-08-11T15:08:03Z")
> [@Julia\_Truchsess](#): > > Type “Control Set” into the search field: That’s not a search engine issue. It’s because that page has been removed from the documentation. We have been telling people for years now to not use control sets and to create arrays of controls instead. ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:10pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/89 "2022-08-11T15:10:36Z")
> [@Ivan\_Tellez](#): > > Deprecated items should be last in the list Unfortunately I don’t think there’s anyway to make them appear last. What we could do is make them not appear at all. We might be able to make them not appear in the search results but still appear if you go directly to the page itself. I’ll give that try because I agree with you that having them appear high in the list is annoying. ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:15pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/90 "2022-08-11T15:15:32Z")
> [@Greg\_O](#): > > If you have to explain all that, it’s a bad design. This is the very first time I have ever had to explain it. And it’s the built-in icon set. It’s not one we created. ---
**Author:** ![Julia\_Truchsess](https://forum.xojo.com/user_avatar/forum.xojo.com/julia_truchsess/32/499_2.png) [@Julia\_Truchsess](https://forum.xojo.com/u/Julia_Truchsess)\ **Post date:** [August 11, 2022, 3:28pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/91 "2022-08-11T15:28:47Z")
> [@Geoff\_Perlman](#): > > We have been telling people for years now to not use control sets and to create arrays of controls instead. I think this is a very misguided initiative. You’ve stated on numerous occasions that your target audience is the somewhat less-advanced coder. One of the most appealing aspects of Xojo for newcomers is the drag-and-drop WYSIWYG GUI editor. Creating controls at runtime, while of course very useful and powerful, is the antithesis of the WYSIWIG GUI creator. It’s an advanced technique. Control sets are extremely useful for beginners and experienced programmers alike, whether or not someone at Xojo thinks that runtime-created controls are cooler. Xojo is supposed to be a RAD environment. Whipping up something with a control set is often quicker for an in-house tool, proof of concept, etc. IMO Xojo should in general refrain from offering subjective opinions about how users should or shouldn’t code in the documentation. Tell us what it does and how it works. You don’t know everyone’s situation and application considerations. ---
**Author:** ![Beatrix\_Willius](https://forum.xojo.com/user_avatar/forum.xojo.com/beatrix_willius/32/282_2.png) [@Beatrix\_Willius](https://forum.xojo.com/u/Beatrix_Willius)\ **Post date:** [August 11, 2022, 3:39pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/92 "2022-08-11T15:39:36Z")
> [@Geoff\_Perlman](#): > > We have been telling people for years now to not use control sets and to create arrays of controls instead. What is the difference? And where did you tell users what? ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:39pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/93 "2022-08-11T15:39:55Z")
> [@Torsten\_Bernhard](#): > > SPHINX is [Python’s](https://www.python.org) documentation engine, so I had a look at Python’s own [documentation](https://docs.python.org/3/). > One notable difference is the search engine. It employs the standard workflow of > > - enter search criteria > - hit ‘enter’ key/search button to launch search > - select desired content from result list > - hit ‘back’ button to get back to result list for selecting other content > > whereas Xojo’s search engine requires > > - enter search criteria > - select desired content from result list > - re-enter search for selecting content from the same result list Yes, Python uses a different search results experience that is not real time. We chose to go with the real time experience. ---
**Author:** ![Tom\_Dixon](https://forum.xojo.com/user_avatar/forum.xojo.com/tom_dixon/32/605_2.png) [@Tom\_Dixon](https://forum.xojo.com/u/Tom_Dixon)\ **Post date:** [August 11, 2022, 3:43pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/94 "2022-08-11T15:43:05Z")
> [@Beatrix\_Willius](#): > > > [@Geoff\_Perlman](#): > > > > We have been telling people for years now to not use control sets and to create arrays of controls instead. > > What is the difference? And where did you tell users what? I thought that is what a control set in Desktop was under the hood, an array of controls? Also it’s very disappointing that that a control array isn’t supported in Web 2. ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:46pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/95 "2022-08-11T15:46:45Z")
> [@Julia\_Truchsess](#): > > You’ve stated on numerous occasions that your target audience is the somewhat less-advanced coder. That is inaccurate. I’m quite sure I have _never_ said that. Our target audience is anyone who wants to create apps fast. Some are hobbyists, some are citizen developers and some are professionals. Even amongst these three groups, the experience and skill level vary quite a bit. > [@Julia\_Truchsess](#): > > IMO Xojo should in general refrain from offering subjective opinions about how users should or shouldn’t code in the documentation. Our goal is to help users be successful. Sometimes that’s developing new features and other times it’s helping them understand good development practices and techniques. ---
**Author:** ![Geoff\_Perlman](https://forum.xojo.com/user_avatar/forum.xojo.com/geoff_perlman/32/48_2.png) [@Geoff\_Perlman](https://forum.xojo.com/u/Geoff_Perlman)\ **Post date:** [August 11, 2022, 3:48pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/96 "2022-08-11T15:48:01Z")
> [@Tom\_Dixon](#): > > I thought that is what a control set in Desktop was under the hood, an array of controls? > > Also it’s very disappointing that that a control array isn’t supported in Web 2. It would seem that way but no, that’s not what they were. What are you trying to accomplish in a web app where a control set would have been the solution? ---
**Author:** ![MarkusR](https://forum.xojo.com/user_avatar/forum.xojo.com/markusr/32/685_2.png) [@MarkusR](https://forum.xojo.com/u/MarkusR)\ **Post date:** [August 11, 2022, 3:50pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/97 "2022-08-11T15:50:46Z")
endless discussion because a search need more input than one textfield … 🤯 ---
**Author:** ![Tom\_Dixon](https://forum.xojo.com/user_avatar/forum.xojo.com/tom_dixon/32/605_2.png) [@Tom\_Dixon](https://forum.xojo.com/u/Tom_Dixon)\ **Post date:** [August 11, 2022, 3:58pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/98 "2022-08-11T15:58:08Z")
> [@Geoff\_Perlman](#): > > What are you trying to accomplish in a web app where a control set would have been the solution? Gosh the last time I wanted to use it was probably over a year ago when testing web 2 features and I moved on and went a different design direction. Since I know it doesn’t work for Web 2 apps I consider it out of my toolkit, but if it was there I likely would consider it for future apps again. ---
**Author:** ![KarenA](https://forum.xojo.com/letter_avatar_proxy/v4/letter/k/c89c15/32.png) [@KarenA](https://forum.xojo.com/u/KarenA)\ **Post date:** [August 11, 2022, 4:37pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/99 "2022-08-11T16:37:52Z")
> [@Geoff\_Perlman](#): > > We have been telling people for years now to not use control sets and to create arrays of controls instead. They have different uses cases… That Xojo inc can’t seem understand that is very disheartening… to say the least. - Karen ---
**Author:** ![Michel\_Bujardet](https://forum.xojo.com/user_avatar/forum.xojo.com/michel_bujardet/32/252_2.png) [@Michel\_Bujardet](https://forum.xojo.com/u/Michel_Bujardet)\ **Post date:** [August 11, 2022, 4:37pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/100 "2022-08-11T16:37:52Z")
> [@Geoff\_Perlman](#): > > We have been telling people for years now to not use control sets and to create arrays of controls instead. That completely defeats the very purpose of the IDE. Control sets can be created in the IDE, whereas arrays of controls have to be created in code. In a control set, event handlers are common to all members. Doing the same with an array of controls requires some doing. ---
**Author:** ![KarenA](https://forum.xojo.com/letter_avatar_proxy/v4/letter/k/c89c15/32.png) [@KarenA](https://forum.xojo.com/u/KarenA)\ **Post date:** [August 11, 2022, 4:39pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/101 "2022-08-11T16:39:54Z")
> [@Geoff\_Perlman](#): > > Our goal is to help users be successful. Sometimes that’s developing new features and other times it’s helping them understand good development practices and techniques. How are control sets bad practice? They certainly help with Xojo being WYSWYG RAD , at least IMO. -Karen ---
**Author:** ![ChristopheDV](https://forum.xojo.com/letter_avatar_proxy/v4/letter/c/59ef9b/32.png) [@ChristopheDV](https://forum.xojo.com/u/ChristopheDV)\ **Post date:** [August 11, 2022, 4:46pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/102 "2022-08-11T16:46:42Z")
> [@Geoff\_Perlman](#): > > We have been telling people for years now to not use control sets and to create arrays of controls instead. When did you say this? And can you share a very good reason why to use arrays controls instead of control sets? Arrays controls are counter productive (to say the least). ---
**Author:** ![Ian\_Kennedy](https://forum.xojo.com/user_avatar/forum.xojo.com/ian_kennedy/32/6860_2.png) [@Ian\_Kennedy](https://forum.xojo.com/u/Ian_Kennedy)\ **Post date:** [August 11, 2022, 5:37pm UTC](https://forum.xojo.com/t/xojo-documentation-is-useless/71524/104 "2022-08-11T17:37:44Z")
> [@Geoff\_Perlman](#): > > That’s not a search engine issue. It’s because that page has been removed from the documentation. We have been telling people for years now to not use control sets and to create arrays of controls instead. Would you like to tell me how to do that, with the IDE, and Menus? As far as I am aware there is no way of doing it. Without writing any code. [Previous page](https://forum.xojo.com/t/xojo-documentation-is-useless/71524.md?page=4) [Next page](https://forum.xojo.com/t/xojo-documentation-is-useless/71524.md?page=6)