Are there performance and style guides?

bostonquad shared this question 4 years ago
Answered

I have some "big picture" questions...


1) Is there a performance guide? I have a .gbb file that's too sluggish in a browser, but it works great in the desktop app (attached, if anyone wants to look). I'm used to low-level programming languages, and I understand, for example, how one manipulates a list can have drastic consequences on performance. It might be greatly helpful to have a list of performance tips.


2) While I'm on the topic, I also wonder if there's a style, standards, or best-practices guide. For instance, I could imagine it being encouraged to make user-movable points be size 5 in blue, while others are black... but I haven't come across such a guide. Do we have one?


Thanks for any responses.

Best Answer

Comments (9)

photo
1

I have a similar question about the performance, because there are lots of awesome online worksheets that are too slow in a browser. I think a guide would be great. Or perhaps there is one already, but I have not found it. It would be nice to have some online worksheets performing normally as in the desktop app.

photo
2

hi

I downloaded the file and did an upload try. I don't see a speed difference or problem between both. But I did already experienced som calculation problems in solving roots of polynomials of advanced grade or in the calculation of integrals, where the online numerical calculation in html5 can't do the job that's no problem in desktop. In those cases I always do an oline trial whether some strategy works or not. And indeed in some cases it's a deception that nice things change into unpractical things.

Concerning lay out practices, even in one country different study books use different styles so imagining an international agreement of best-practices looks as whishful thinking. But I always try to follow some rules for myself:

Mark objects you don't want to be changed as 'selection not allowed' or fix them. E.g. your file will look as a mess if a users starts moving texts. Even if it's not your intention to move them, prevent others can.

Give objects you do want to be changed another color or at least a much bigger style, and if it's not clear type in a (very) small text what to do with the file.

The default color of polygons is far from nice, so always change it and try to use as much as possible the same colors for the same things. Make a list and after making some, it will become your habbit. Be carefull with red, as for points o a graph they can be understood an not being defined in the function.

Always use LaTeX for texts and use the little possible different textstyles in one file.

Give sliders and/or inputfields the same color as the object they are related with.

Use a default Font size thats lage enough, surely do if you want to project it in a classroom.

Group things so the reading of the file doens't look like a puzzle for a user who's not familiar with your file. Try to look at your own file as a user who always want things to be very clear. The understanding of your file itself musn't take to much concentration.


I'm sure these things look normal, but considering them as standard procedure, many files indeed would look much more nice than they do now.

chris

photo
2

Hello,


These are a few style guides I use: Feel free to reference this worksheet as a similar illustration.


1) Minimize the amount of text you put on a worksheet. Less text = more elegant appearance.


2) For text that needs to appear on screen, make sure you right click on text and select "fix object" and "ABSOLUTE POSITION on SCREEN". This will ensure text doesn't move as you zoom out.


3) I NEVER put the algebra perspective in any worksheet I upload simply because it just looks messy. Some teachers think they're doing students a favor by putting all that info there. In my opinion, they're not. In the applet I attached, I could have left the algebra perspective there (for the user to enter definition for function g. However, by just putting an input box with caption "g(x) = ", and linking this input box to function g, user can now input any function he/she wants without ever seeing algebra perspective.


4) If your boolean checkboxes for "inscribed" and "circumscribed" are called "a" and "b", under scripting for "a", (on update), type in "SetValue[a, true]" in line 1 and type in "SetValue[b,false]" in line 2. For the other boolean variable, do similar but set b,true and a,false. This will cause only one set of rectangles to be seen at a time.


5) You may also want to hide points in the sequence that don't need to be seen (vertices of polygons).


Hope this helps.


Good luck!


Tim Brzezinski

GeoGebra Page

Twitter: @dynamic_math

photo
1

Hi Tim ...

always good to read ideas ...


But I think you can use the algebra view in a reduced way like I did it in this worksheet.

https://www.geogebra.org/m/TQzzSRdF

I changed the display of the objects and show a textual definition of them. Then the pupil can see the definition of the objects and do the steps on their own.

photo
photo
2

Check out https://www.geogebra.org/m/nmw6Dhdk.


A few tips:


1) Minimize text in worksheet. If text is necessary, it's best to be dynamic. If text is there, check "Fix Object" and "Absolute Value on Screen".


2) may want to show only one set of differential rectangles at a time. If so, see this page to check only one checkbox at a time: http://www.geogebra.org/man...


3) Keep window size SMALL! The applet I uploaded to the sheet above is 738 x 435.


Tim Brzezinski

photo
1

Why don't you have a look at some of the worksheets and find out what are you favorite ideas to have good worksheets?

photo
2

Thank you everybody for the info and hints. I will try to update some of my worksheets following your advice. I will start with this one https://www.geogebra.org/m/y36KxBZ6 which works very slow in the browser.


Kind regards

photo
1

Thanks everyone for all your advice! (I know this is an old thread; I hope better late than never. I had to put my project on hold, but I'm getting back to it now.)

© 2021 International GeoGebra Institute