# Documentation gripe

**URL:** <https://forum.xojo.com/t/documentation-gripe/50606>\
**Category:** General\
**Created:** [October 12, 2019, 1:31pm UTC](https://forum.xojo.com/t/documentation-gripe/50606 "2019-10-12T13:31:18Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![Perry\_Paolantonio](https://forum.xojo.com/user_avatar/forum.xojo.com/perry_paolantonio/32/4353_2.png) [@Perry\_Paolantonio](https://forum.xojo.com/u/Perry_Paolantonio)\
**Post date:** [October 12, 2019, 1:31pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/1 "2019-10-12T13:31:18Z")

</div>

We’re still on Xojo 2017r3, and will be for a little while before moving to 2019. With all the changes in the new version, I’m finding the online documentation less and less useful because it now only covers the latest version. Is there some way to include in the docs some reference to old stuff? Or maybe links to the previous docs?

For example, in the new documentation for a Progress Bar, the maximum value property is set with Progressbar.MaximumValue, but in older versions it’s just “Maximum” – while the page for ProgressBar ([ProgressBar (deprecated) — Xojo documentation](https://documentation.xojo.com/api/deprecated/progressbar.html)) makes a reference to MaximumValue, the MaximumValue page it links to ([ProgressBar (deprecated) — Xojo documentation](https://documentation.xojo.com/api/deprecated/progressbar.html#progressbar-maximumvalue)) makes reference to both “Maximum” and “MaximumValue” with no distinction about which version of Xojo each applies to – the issue here is that if I’m in the IDE and want to look up what a property does, I can’t find that property from the ProgressBar page. I realize it’s an obvious leap from maximum to maximumvalue, but I’ve wasted a bunch of time over the past few days trying to find things in my version that don’t exist in the docs because it’s been eliminated. It would really be useful to have access to the docs for previous versions of Xojo for those of us not on the bleeding edge.

I totally get the push users to the new API, and we’ll get there. But in the mean time, it’s hard to find information on the tools we’re using when the page makes no reference or talks about stuff that’s not in our version.

---

<div class="post-metadata">

**Author:** ![TimStreater](https://forum.xojo.com/user_avatar/forum.xojo.com/timstreater/32/586_2.png) [@TimStreater](https://forum.xojo.com/u/TimStreater)\
**Post date:** [October 12, 2019, 1:35pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/2 "2019-10-12T13:35:34Z")

</div>

The most useful thing would have been to have the old, deprecated, methods etc still listed in the doc, but marked somehow as deprecated. That would ease migration. The pages are still there, after all.

---

<div class="post-metadata">

**Author:** ![KarenA](https://forum.xojo.com/letter_avatar_proxy/v4/letter/k/c89c15/32.png) [@KarenA](https://forum.xojo.com/u/KarenA)\
**Post date:** [October 12, 2019, 1:37pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/3 "2019-10-12T13:37:49Z")

</div>

What I would suggest is setting the IDE to use the local reference for your IDE version and making a bookmark in your browser for the new docs…

That way you can keep using API 1.0… Of course that means you need to keep two version of the IDE open if you want API 1.0 docs while using 2019R2+

- Karen

---

<div class="post-metadata">

**Author:** ![Perry\_Paolantonio](https://forum.xojo.com/user_avatar/forum.xojo.com/perry_paolantonio/32/4353_2.png) [@Perry\_Paolantonio](https://forum.xojo.com/u/Perry_Paolantonio)\
**Post date:** [October 12, 2019, 1:39pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/4 "2019-10-12T13:39:19Z")

</div>

[quote=457842:@Karen Atkocius]What I would suggest is setting the IDE to use the local reference for your IDE version and making a bookmark in your browser for the new docs…

[/quote]

sure - but the best way to find stuff in the online docs is with google, not browsing the documentation (at least for me)

---

<div class="post-metadata">

**Author:** ![Jean-Yves\_Pochez](https://forum.xojo.com/user_avatar/forum.xojo.com/jean-yves_pochez/32/21769_2.png) [@Jean-Yves\_Pochez](https://forum.xojo.com/u/Jean-Yves_Pochez)\
**Post date:** [October 12, 2019, 5:33pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/5 "2019-10-12T17:33:58Z")

</div>

you can use Dash and keep track of old xojo documentation, use the one you want  
also you can search on them like with google.

---

<div class="post-metadata">

**Author:** ![Mark\_Carlton](https://forum.xojo.com/letter_avatar_proxy/v4/letter/m/9dc877/32.png) [@Mark\_Carlton](https://forum.xojo.com/u/Mark_Carlton)\
**Post date:** [October 12, 2019, 11:22pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/6 "2019-10-12T23:22:22Z")

</div>

I second Dash, my old version of 2.2.6 has available 2017r3 up to 2019r1.1 in separate docsets, I find it the only way to make sense of the documentation.  
I do not find the official documentation path particularly friendly or obvious in use.

---

<div class="post-metadata">

**Author:** ![Javier\_Menéndez](https://forum.xojo.com/user_avatar/forum.xojo.com/javier_men%C3%A9ndez/32/153_2.png) [@Javier\_Menéndez](https://forum.xojo.com/u/Javier_Men%C3%A9ndez)\
**Post date:** [October 13, 2019, 8:15am UTC](https://forum.xojo.com/t/documentation-gripe/50606/7 "2019-10-13T08:15:17Z")

</div>

Does these tips help (from the Xojo Blog)? [https://blog.xojo.com/2019/10/09/use-doc-categories-to-find-information-fast/](https://blog.xojo.com/2019/10/09/use-doc-categories-to-find-information-fast/)

---

<div class="post-metadata">

**Author:** ![PaulS](https://forum.xojo.com/user_avatar/forum.xojo.com/pauls/32/199_2.png) [@PaulS](https://forum.xojo.com/u/PaulS)\
**Post date:** [October 13, 2019, 8:54am UTC](https://forum.xojo.com/t/documentation-gripe/50606/8 "2019-10-13T08:54:42Z")

</div>

> [@457965:@Javier Menéndez](#):
>
> Does these tips help (from the Xojo Blog)? [Use Doc Categories to Find Information Fast – Xojo Programming Blog](https://blog.xojo.com/2019/10/09/use-doc-categories-to-find-information-fast/)

No it doesn’t.  
Perry is asking for the online 2017r3 documentation.  
The links in the Xojo Blog are all about 2019r2.

The main problem is that it is not possible to select for what Xojo version you wish to see the documentation.  
You always get the documentation of the latest version.  
Usually that’s not a major problem, but with 2019r2 it very much is.

---

<div class="post-metadata">

**Author:** ![Javier\_Menéndez](https://forum.xojo.com/user_avatar/forum.xojo.com/javier_men%C3%A9ndez/32/153_2.png) [@Javier\_Menéndez](https://forum.xojo.com/u/Javier_Men%C3%A9ndez)\
**Post date:** [October 13, 2019, 8:59am UTC](https://forum.xojo.com/t/documentation-gripe/50606/9 "2019-10-13T08:59:57Z")

</div>

Yup, I see

In that case, maybe switching the “Use built-in documentation” preferences in the IDE can do the thing.

Javier

---

<div class="post-metadata">

**Author:** ![Jean-Yves\_Pochez](https://forum.xojo.com/user_avatar/forum.xojo.com/jean-yves_pochez/32/21769_2.png) [@Jean-Yves\_Pochez](https://forum.xojo.com/u/Jean-Yves_Pochez)\
**Post date:** [October 13, 2019, 9:25am UTC](https://forum.xojo.com/t/documentation-gripe/50606/10 "2019-10-13T09:25:14Z")

</div>

[quote=457978:@Javier Menéndez]In that case, maybe switching the “Use built-in documentation” preferences in the IDE can do the thing.

[/quote]  
yes, but it’s trickier to search in the content of the documentation. you can only search for language keywords.

---

<div class="post-metadata">

**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:** [October 13, 2019, 12:50pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/11 "2019-10-13T12:50:54Z")

</div>

[quote=457975:@Paul Sondervan]Perry is asking for the online 2017r3 documentation.  
The links in the Xojo Blog are all about 2019r2.[/quote]  
This is not new.

The internet documentation is always for the current version which 2017r3 is not since 2 years ago.

Perry have to set the documentation to LOCAL.

What I sometimes do is to copy the whole page, Paste it in a WP and made my searches there. Not fast, yes. This is a price to pay for not been current.

---

<div class="post-metadata">

**Author:** ![Norman\_Palardy](https://forum.xojo.com/user_avatar/forum.xojo.com/norman_palardy/32/169_2.png) [@Norman\_Palardy](https://forum.xojo.com/u/Norman_Palardy)\
**Post date:** [October 13, 2019, 7:38pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/12 "2019-10-13T19:38:19Z")

</div>

> [@457985:@Jean-Yves Pochez](#):
>
> yes, but it’s trickier to search in the content of the documentation. you can only search for language keywords.

the one I rewrote uses a full text search

---

<div class="post-metadata">

**Author:** ![Jean-Yves\_Pochez](https://forum.xojo.com/user_avatar/forum.xojo.com/jean-yves_pochez/32/21769_2.png) [@Jean-Yves\_Pochez](https://forum.xojo.com/u/Jean-Yves_Pochez)\
**Post date:** [October 13, 2019, 8:02pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/13 "2019-10-13T20:02:39Z")

</div>

> [@458096:@Norman Palardy](#):
>
> the one I rewrote uses a full text search

is it implemented and verified ? 😉  
you can’t search for some help page content, or I don’t know how to.

---

<div class="post-metadata">

**Author:** ![Norman\_Palardy](https://forum.xojo.com/user_avatar/forum.xojo.com/norman_palardy/32/169_2.png) [@Norman\_Palardy](https://forum.xojo.com/u/Norman_Palardy)\
**Post date:** [October 13, 2019, 8:07pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/14 "2019-10-13T20:07:46Z")

</div>

in 2019r2 ?  
I have no idea … I dont work there any more so I have no idea if the tool I wrote that built the db has been altered or not and whether it does / doesnt still create the full text search  
the tables for it sure still seem to be there though

---

<div class="post-metadata">

**Author:** ![system](https://forum.xojo.com/uploads/default/original/1X/455b4dcc0e61630e9f81940004ddffa49c432a46.png) [@system](https://forum.xojo.com/u/system)\
**Post date:** [April 29, 2021, 4:07pm UTC](https://forum.xojo.com/t/documentation-gripe/50606/15 "2021-04-29T16:07:21Z")

</div>


